Build with APEX API
Programmatically create, deploy, and manage AI agents. Integrate APEX into your workflows with our RESTful API.
Quick Start
Terminal
# List your agentscurl -H "Authorization: Bearer apex_live_YOUR_KEY" \https://your-domain.com/api/v1/agents# Create an agentcurl -X POST -H "Authorization: Bearer apex_live_YOUR_KEY" \-H "Content-Type: application/json" \-d '{"name":"Sales Bot","role":"sales","description":"Outbound sales agent"}' \https://your-domain.com/api/v1/agents# Run an agentcurl -X POST -H "Authorization: Bearer apex_live_YOUR_KEY" \-H "Content-Type: application/json" \-d '{"goal":"Generate 10 leads for SaaS product"}' \https://your-domain.com/api/v1/agents/AGENT_ID/run
Authentication
All API requests require a valid API key passed in the Authorization header:
Authorization: Bearer apex_live_your_api_key_here
Generate keys from the API Keys settings page. Each key can have custom permissions and rate limits.
Endpoint Reference
| Method | Endpoint | Description | Auth |
|---|---|---|---|
| GET | /api/v1/agents | List workspace agents (paginated, filterable) | Required |
| POST | /api/v1/agents | Create a new agent | Required |
| GET | /api/v1/agents/:id | Get agent details | Required |
| PATCH | /api/v1/agents/:id | Update an agent | Required |
| DELETE | /api/v1/agents/:id | Delete an agent | Required |
| POST | /api/v1/agents/:id/run | Start agent with a goal/task | Required |
| POST | /api/v1/agents/:id/chat | Send message, get response | Required |
| GET | /api/v1/marketplace | Search marketplace listings | Required |
| POST | /api/v1/marketplace/:id/install | Install a marketplace agent | Required |
| GET | /api/v1/events | Stream events (SSE) or list events | Required |
| POST | /api/v1/events | Create a custom event | Required |
| GET | /api/v1/webhooks | List webhooks | Required |
| POST | /api/v1/webhooks | Create a webhook | Required |
Rate Limits
Rate limits are applied per API key and can be configured when creating a key.
60 req/min
Default
Standard tier
300 req/min
Pro
Pro plan keys
600 req/min
Enterprise
Enterprise keys
Rate limit information is included in every response:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1712035200
When rate limited, the API returns 429 Too Many Requests with a Retry-After header.
SDKs
Python
pip install apex-sdkJavaScript / TypeScript
npm install @apex-ai/sdkREST API
curl -H 'Authorization: Bearer ...'Ready to start building?
Generate an API key and deploy your first agent in minutes.
Get Your API Key