Skip to main content
POST
/
v1
/
agents
/
{agent_id}
/
webhook
/
rotate-secret
curl -X POST https://api.dari.dev/v1/agents/agt_123/webhook/rotate-secret \
  -H "Authorization: Bearer $DARI_API_KEY"

{
  "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.

Replace the signing secret used for one agent’s webhook deliveries. The response returns the new signing_secret once. Store it immediately, then update your webhook receiver to verify future deliveries with the new value. The agent must already have a webhook configured. Use Set Agent Webhook first if webhook_url is not configured.

​
Path Parameters

​
agent_id
string
required
Agent ID.

​
Headers

​
Authorization
string
required
Bearer token using your Dari API key.

​
Response Fields

​
webhook_url
string
Configured webhook URL.
​
signing_enabled
boolean
Whether Dari signs webhook deliveries for this agent.
​
signing_secret
string
New signing secret. Store it immediately; Dari does not return it again.
curl -X POST https://api.dari.dev/v1/agents/agt_123/webhook/rotate-secret \
  -H "Authorization: Bearer $DARI_API_KEY"

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