Public API
Authentication
How to send a workspace API key on every public /v1 request.
Create a key under Settings → Developer Access (workspace admins only). Choose Secret (dhvanee_live_…) for servers and MCP, or Publishable (dhvanee_pub_…) for read-only use in mobile or partner apps.
Secret keys are shown once when created. Publishable keys stay visible in the dashboard so you can copy them again.
The machine-readable contract is `openapi.public.yaml`. Download it for clients and codegen. This site has no live Try-it console.
Base URL
https://api.stage.dhvanee.comKey kinds
dhvanee_live_— secret key; may include write scopes andcopilot:use.dhvanee_pub_— publishable key; read scopes only (*:read, notcopilot:use).
Set
DHVANEE_API_KEY in the local MCP config to a secret key, not a publishable key.Headers
| Header | Value |
|---|---|
| Authorization | Bearer dhvanee_live_YOUR_KEY |
| X-API-Key | dhvanee_live_YOUR_KEY |
Use either header. If both are present they must be the same value.
Example
curl -sS -X GET "https://api.stage.dhvanee.com/v1/contacts?limit=5" \
-H "Authorization: Bearer dhvanee_live_YOUR_KEY"Scopes
Each key lists the scopes it may use. Missing a scope returns 403. Unknown scopes are refused when the key is created.
contacts:read/contacts:writecalls:read/calls:writecampaigns:read/campaigns:writeagents:read/agents:writeknowledge:read/knowledge:writeautomations:read/automations:writeaccount:readcopilot:usenumbers:read/numbers:write
Webhook subscriptions use the dashboard session, not a data API key. See Webhooks.
Was this page helpful?