Public API overview
Workspace REST API for contacts, calls, campaigns, agents, knowledge, automations, copilot, account, and owned phone numbers.
The public API is the supported way to automate a workspace outside the dashboard. Send requests to https://api.stage.dhvanee.com with a key from Settings → Developer Access.
What you can do
Authentication
Bearer or X-API-Key, scopes, and key lifecycle.
Errors
401, 403, 404, 409, 422, and how detail is shaped.
Rate limits
60 requests per key per minute and Retry-After.
Credits
When the API returns 402 for plan limits.
Contacts
List, create, update, and delete contacts.
Calls
Place, read, and stop outbound calls.
Campaigns
Create and control outbound campaigns.
Agents
Agents, workflows, publish, and versions.
Knowledge
Documents and agent attachments.
Automations
Workflows, activate, and runs.
Copilot
One turn of the workspace copilot.
Account
Read plan balances for the key's workspace.
Phone numbers
List, import, attach, and detach owned numbers.
Webhooks
Contact and call events signed with HMAC.
Local MCP
Run the stdio MCP next to Cursor or Claude Desktop.
Base URL
https://api.stage.dhvanee.comQuick start
curl -sS -X GET "https://api.stage.dhvanee.com/v1/contacts?limit=5" \
-H "Authorization: Bearer dhvanee_live_YOUR_KEY"Not in this API
- Buying a phone number or searching a number shop
- Wallet top-up, plan changes, or checkout
- Reseller or credit transfer
- Storing CRM OAuth secrets (use the dashboard connections UI)