Dhvanee DocsDashboard
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.com

Key kinds

  • dhvanee_live_ — secret key; may include write scopes and copilot:use.
  • dhvanee_pub_ — publishable key; read scopes only (*:read, not copilot:use).
Set DHVANEE_API_KEY in the local MCP config to a secret key, not a publishable key.

Headers

HeaderValue
AuthorizationBearer dhvanee_live_YOUR_KEY
X-API-Keydhvanee_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:write
  • calls:read / calls:write
  • campaigns:read / campaigns:write
  • agents:read / agents:write
  • knowledge:read / knowledge:write
  • automations:read / automations:write
  • account:read
  • copilot:use
  • numbers:read / numbers:write
Webhook subscriptions use the dashboard session, not a data API key. See Webhooks.
Was this page helpful?