Developers (voice)
Find your organisation and agent IDs, manage webhooks, see your API keys and the public API endpoints.
Where to find it
Voice › Voice overview › Developers
Open this screen
Steps
- Open Voice › Voice overview and press Open the page on Developers.
- In Agent ID / API, copy the Organisation ID, Organisation slug or an Agent ID.
- In Webhooks, press Add endpoint to receive call and contact events at your own https address.
- In API keys, check your keys, when they were last used and whether they are Active or Revoked.
- In Public endpoints and Docs, copy an endpoint or press Open the API reference.
Settings on this screen
| Setting | What it does | Default |
|---|---|---|
| Agent ID / API | Organisation ID, Organisation slug, API mode (Sandbox or Live) and the Agent ID of the chosen AI agent. | — |
| Webhooks | Your https endpoints, their events, last delivery and failures. | — |
| API keys | Keys issued by the CallDesk operator: name, first characters, scopes, last used, requests, status. | — |
| Public endpoints | The /api/v1 endpoints with a Copy button each, and the agent chat endpoint. | — |
| Docs | Open the API reference and OpenAPI (JSON). | — |
Tips
- Send your key as "Authorization: Bearer <key>".
Good to know
- Everyone can read this page; only managers can add, test or delete webhooks.
- Speaking a reply in the agent's voice has no API endpoint; the row shows Not connected yet.
Related how-tos
- Copy your organisation and agent IDs Get the identifiers you need to call the public API.
- Add and test a webhook Receive call and contact events at your own https endpoint, signed so you can check they came from CallDesk.
- See your API keys Check which API keys your organisation has and how they are used.
- Public API endpoints and docs Find the API endpoints for calls and your agent, and open the full reference.
- Developers: fixing webhook problems Fix the messages the Developers page can show.
- API reference for developers Connect your own app to your workspace: the REST API, its keys and scopes, errors, rate limits and webhooks.