Developers
A REST API for the autonomous company.
Everything you can do in Maya OS, you can do over the API. Predictable resource-oriented URLs, JSON payloads, and standard HTTP verbs.
Authentication
Authenticate with a bearer token.
All requests must be made over HTTPS and include your secret key in the Authorization header. Keys are scoped per workspace — never expose a live key in client-side code.
Base URL (US)
https://api.maya-os.com/v1
Base URL (EU)
https://eu.api.maya-os.com/v1
Authorization header
HTTP
curl https://api.maya-os.com/v1/agents \
-H "Authorization: Bearer sk_live_8f2a...c019"
# Test mode uses a sandboxed workspace
curl https://api.maya-os.com/v1/agents \
-H "Authorization: Bearer sk_test_4b1d...9a72"Reference
Core endpoints.
GET
/v1/agents
List every agent in the workspace.
POST
/v1/agents
Create a new agent in a given module.
GET
/v1/conversations
Retrieve omnichannel conversations.
POST
/v1/conversations/{id}/reply
Send a reply on an open thread.
GET
/v1/deals
List sales pipeline deals with filters.
POST
/v1/webhooks
Subscribe an endpoint to platform events.
Example
Create an agent.
Request
POST
POST /v1/agents
{
"name": "Support Agent",
"module": "support",
"channels": ["whatsapp", "email"],
"autonomy": "tier_1"
}
Response
200 OK
{
"id": "agt_7Hk2pQ",
"name": "Support Agent",
"module": "support",
"status": "active",
"created_at": "2026-06-23T09:14:02Z"
}Rate limits
Limits are applied per API key. When you exceed a limit we return 429 Too Many Requests with a Retry-After header. Enterprise plans get custom ceilings.
Starter
100
/min
Growth
1,000
/min
Enterprise
Custom
Start building today.
Grab a test key, read the guides, and ship your first integration this afternoon.