apunkt/dograh
1
0
Fork 0
mirror of https://github.com/dograh-hq/dograh.git synced 2026-06-22 08:38:13 +02:00
Code Issues Projects Releases Packages Wiki Activity

chore: updatae documentation for api trigger

Browse source
This commit is contained in:
Abhishek Kumar 2026-05-04 12:46:11 +05:30
parent 5ad5bbd985
commit 0d7b225f76
12 changed files with 120 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

15
docs/voice-agent/api-trigger.mdx
View file

@ -36,7 +36,7 @@ The request body, headers, and response shape are identical for both URLs.
## Making a request
Authenticate by passing your API key in the `X-API-Key` header. The request body requires a `phone_number` and accepts an optional `initial_context` object.
Authenticate by passing your API key in the `X-API-Key` header. The request body requires a `phone_number` and accepts optional `initial_context` and `telephony_configuration_id` fields.
```bash
curl -X POST https://your-dograh-instance/api/v1/public/agent/{uuid} \
@ -92,6 +92,19 @@ You can reference the user's name in your prompt as `{{initial_context.user.name
See [Context & Variables](/core-concepts/context-and-variables) for more on how data flows through a call.
## Choosing a telephony configuration
By default, calls are placed through your organization's default outbound [telephony configuration](/integrations/telephony/overview). To route a specific call through a different configuration — for example, to dial out from a regional number — pass `telephony_configuration_id` in the request body.
```json
{
"phone_number": "+14155550100",
"telephony_configuration_id": 42
}
```
The id is shown on each row in **Telephony configurations** (`https://app.dograh.com/telephony-configurations` for hosted or `http://localhost:3010/telephony-configurations` for local). The configuration must belong to the same organization as the API Trigger; otherwise the request returns `404`.
<Note>
For full endpoint details including all parameters and response fields, see the [API reference](/api-reference/calls/trigger).
</Note>