DocsAPI referenceWebhooks
Delete a webhook endpoint
Its deliveries still pending fail with endpoint_deleted. Jobs' own webhook_url deliveries are not affected.
DELETE /v1/webhook-endpoints/{id}
Needs an API key: Authorization: Bearer $VIDEXO_API_KEY.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string, up to 64 characters | The endpoint id. |
Request
bash
curl --fail-with-body -X DELETE "$VIDEXO_API_URL/v1/webhook-endpoints/we_4n8c2kq0x7m1v5z3b9r6t0wa" \
-H "Authorization: Bearer $VIDEXO_API_KEY"Copy failed. The text is selected; copy it with your keyboard.
JavaScript
const response = await fetch(`${process.env.VIDEXO_API_URL}/v1/webhook-endpoints/we_4n8c2kq0x7m1v5z3b9r6t0wa`, {
method: 'DELETE',
headers: { Authorization: `Bearer ${process.env.VIDEXO_API_KEY}` },
});
// 204: no body.
if (!response.ok) throw new Error(`The delete returned ${response.status}`);Copy failed. The text is selected; copy it with your keyboard.
Response
204 headers
HTTP/1.1 204 No ContentCopy failed. The text is selected; copy it with your keyboard.
Responses
| Status | Body | When |
|---|---|---|
| 204 | none | Deleted. |
| 401 | Problem | authentication_failed (missing_api_key, invalid_api_key, api_key_revoked, api_key_expired) |
| 403 | Problem | permission_denied (token_scope): a client token cannot call this route |
| 404 | Problem | not_found (webhook_endpoint) |
| 429 | Problem | rate_limited, with Retry-After in seconds |