Download the PHP package administrate/sdk without Composer
On this page you can find all versions of the php package administrate/sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download administrate/sdk
More information about administrate/sdk
Files in administrate/sdk
Package sdk
Short Description The official PHP SDK for the Administrate.dev REST API
License MIT
Homepage https://github.com/administrate-dev/administrate-php-sdk
Informations about the package sdk
Administrate PHP SDK
The official PHP SDK for the Administrate.dev REST API.
Administrate.dev is AI Agency Management software. It is a monitoring and management platform for AI agencies running n8n and AI automation workflows across multiple clients. It provides a single dashboard to track every workflow, every client, every failure, and all LLM costs, so you can catch problems before clients do and prove the value of your automations.
Key platform features:
- Multi-instance monitoring -- See all n8n instances across every client in one place
- Error tracking -- Real-time failure detection with automatic error categorization
- LLM cost tracking -- Connect OpenAI, Anthropic, Azure, and OpenRouter accounts to attribute costs to specific clients
- Workflow insights -- Execution counts, success rates, and time-saved ROI reporting
- Sync health -- Know instantly when a data sync fails
- Webhooks & API -- Full programmatic access for custom integrations
Installation
Install via Composer:
Requires PHP 8.1+.
Quick start
Configuration
You can also pass any PSR-18 compatible HTTP client:
API reference
All API keys are created in Settings > Developers within Administrate.dev. Tokens have three permission levels: read, write, and full.
Account
Clients
Clients represent the companies you manage automations for.
Instances
Instances are n8n deployments connected to Administrate.
Workflows
Executions
Executions are read-only records of workflow runs synced from n8n.
Sync runs
Users
Webhooks
API tokens
LLM providers
Connect your AI provider accounts to track costs.
LLM projects
Projects are discovered automatically when syncing a provider. Assign them to clients to attribute costs.
LLM costs
Pagination
All ->list() methods return an IteratorAggregate that handles pagination automatically. By default, the API returns 25 items per page (max 100).
Error handling
The SDK raises typed exceptions for all API errors:
Exception hierarchy:
| Exception | Status code | Description |
|---|---|---|
AdministrateException |
-- | Base exception for all SDK errors |
ApiException |
Any non-2xx | Base for all HTTP API errors |
AuthenticationException |
401 | Invalid or missing API key |
PermissionDeniedException |
403 | Insufficient token permissions |
NotFoundException |
404 | Resource does not exist |
ValidationException |
422 | Invalid request parameters |
RateLimitException |
429 | Rate limit exceeded (has retryAfter) |
InternalServerException |
5xx | Server-side error |
ConnectionException |
-- | Failed to connect to the API |
TimeoutException |
-- | Request timed out |
All ApiException subclasses expose statusCode and body (parsed JSON or string).
Retries
The SDK automatically retries failed requests with exponential backoff:
- 429 (rate limited) -- Retries after the duration specified in the
Retry-Afterheader - 5xx (server errors) -- Retries with exponential backoff (0.5s, 1s, 2s, ...)
- Connection errors and timeouts -- Retried with the same backoff schedule
By default, the SDK retries up to 3 times. Set maxRetries: 0 to disable:
Requirements
- PHP 8.1+
- Guzzle >= 7.5
License
MIT