Webhooks

Delete a webhook

View as Markdown
Delete a webhook by its ID. **400 is returned when the webhook still has active agent subscriptions:** `"Cannot delete webhook: It is currently assigned to one or more agents. Please remove all agent assignments first."` Call `DELETE /agent/{agentId}/webhook-subscriptions` for each assigned agent before deleting. **400 is also returned for an invalid webhook ID format:** `"The provided Webhook ID is invalid."`

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired
The ID of the webhook to delete

Response

Webhook deleted successfully
statusboolean
datastring
Success message

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error