PATCH
/v1/workspace/webhooks/{webhook_id}
ElevenLabs APIUpdate Workspace Webhook
- Base URL
- https://api.elevenlabs.io
- Auth
- xi-api-key: <ELEVENLABS_API_KEY>
- Last verified
- 2026-09-03 · upstream hash matched
Actions
Agents: curl -H "Accept: text/markdown" this URL
→ 214 tokens · Vary: Accept
→ 214 tokens · Vary: Accept
Critical gotchas
Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.
Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.
cURL
curl -X PATCH 'https://api.elevenlabs.io/v1/workspace/webhooks/webhook-id' \ -H "xi-api-key: $ELEVENLABS_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "is_disabled": true, "name": "string", "retry_enabled": true, "request_headers": {}, "events": [ "voice_library_removal_notice" ]}'Get a free ElevenLabs API key → sponsored
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| webhook_id | path | string | Yes | The unique ID for the webhook |
| is_disabled | body | boolean | Yes | Whether to disable or enable the webhook |
| name | body | string | Yes | The display name of the webhook (used for display purposes only). |
| retry_enabled | body | boolean | No | Whether to enable automatic retries for transient failures (5xx, 429, timeout) |
| request_headers | body | object | No | A list of request headers to include with the webhook delivery (optional) |
| events | body | string[] | No | The complete set of workspace-level events this webhook should be subscribed to. The webhook is added to the events in the list and removed from any not in the list. Omit to leave the current event subscriptions unchanged. |
Response 200 OK
{
"status": "ok"
}