Base URL
All endpoints are relative to:| Prefix | Service |
|---|---|
/core | Agents, conversations, phone numbers, trunks, web widgets, email, inbound routing |
/knowledge-base | Knowledge bases (datasets), sources, retrieval |
/workflow | Workflows, executions, triggers |
/campaign | Outbound campaigns, contacts, configurations |
/mcp | Model Context Protocol server |
Conventions
- Requests — send JSON with a
Content-Type: application/jsonheader. List endpoints take filters as query parameters and paginate with a cursor. - Responses — always JSON. Timestamps are ISO 8601 (UTC). IDs are opaque strings; don’t parse them.
- Authentication — every request needs a bearer credential (
ak_orpat_). See Authentication. - Errors — non-2xx responses return a JSON
detailmessage. See Errors.
Resources
Authentication
Authorize requests with an API key or personal access token.
Errors
Error format and status codes.
Conversations
Create, list, retrieve, and message conversations.
Knowledge bases
Datasets, sources, and retrieval.
Agents
Manage agents, versions, publishing, and deployment.
Campaigns
Create campaigns, upload contacts, and read stats.
Domains, addresses, and unsubscribes.
Web widgets
Manage widgets and the public widget runtime.
Telephony
Phone numbers, trunks, and inbound routing.
Workflows
Manage workflows and run executions.

