Skip to main content
PUT
/
v1
/
agents
/
{agent_id}
/
webhook
curl -X PUT https://api.dari.dev/v1/agents/agt_123/webhook \
  -H "Authorization: Bearer $DARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://example.com/dari/webhook"}'

{
  "webhook_url": "https://example.com/dari/webhook",
  "signing_enabled": true,
  "signing_secret": "whsec_..."
}

Documentation Index

Fetch the complete documentation index at: https://docs.dari.dev/llms.txt

Use this file to discover all available pages before exploring further.

Configure the HTTPS endpoint that receives tool.call_requested webhooks for one agent. See Webhooks for payloads, signing, and result submission. 
GET /v1/agents/{agent_id}/webhook
PUT /v1/agents/{agent_id}/webhook
DELETE /v1/agents/{agent_id}/webhook
POST /v1/agents/{agent_id}/webhook/rotate-secret
PUT creates or updates the webhook URL. GET returns the current URL and whether signing is enabled, but never returns the existing secret. POST /rotate-secret replaces the signing secret and returns the new value once. DELETE clears the webhook configuration.

​
Path Parameters

​
agent_id
string
required
Agent ID.

​
Headers

​
Authorization
string
required
Bearer token using your Dari API key.
​
Content-Type
string
required
Must be application/json for PUT.

​
Request Body

​
webhook_url
string
required
Absolute webhook URL. Production URLs must use HTTPS, must not include username/password information, and must resolve to public IP addresses.

​
Response Fields

​
webhook_url
string | null
Configured webhook URL, or null when no webhook is configured.
​
signing_enabled
boolean
Whether Dari signs webhook deliveries for this agent.
​
signing_secret
string | null
Returned only when the secret is created or rotated. Store it immediately.
curl -X PUT https://api.dari.dev/v1/agents/agt_123/webhook \
  -H "Authorization: Bearer $DARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://example.com/dari/webhook"}'

{
  "webhook_url": "https://example.com/dari/webhook",
  "signing_enabled": true,
  "signing_secret": "whsec_..."
}