/v1/workspaces/{workspace_id}/webhooks/{id}AuthUpdate url / active flag (active=true clears auto-disable)
Deprecated: use `/v1/workspaces/{workspace_id}/webhooks/endpoints` (event filter, event descriptions, Send test that reports the result, event log, replay, rotation with a grace period). Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.
Path parameters
workspace_id*string · uuidId of the workspace.
id*string · uuidId of the webhook.
Request body
urlstringNew destination URL.
activebooleanPause/resume the webhook. Setting active=true clears auto-disable.
Response · 200 Updated webhook (secret masked).
id*string · uuidworkspace_id*string · uuidurl*stringactive*booleanWhether it receives events (`enabled` on the new routes).
failure_count*numberFailed deliveries in a row (`consecutive_failures` on the new routes).
last_status_code*numberHTTP status of the latest attempt.
last_attempt_at*string · date-timeWhen the latest attempt was made.
auto_disabled_at*string · date-timeSet when it was switched off automatically after sustained failures.
first_failure_at*string · date-timecreated_at*string · date-timesecret_setbooleanAlways true: every webhook has a signing secret.
Example
Request
PATCH https://api.trawl.productcraft.co/v1/workspaces/{workspace_id}/webhooks/{id}
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"url": "string",
"active": false
}Response
{
"id": "00000000-0000-0000-0000-000000000000",
"workspace_id": "00000000-0000-0000-0000-000000000000",
"url": "string",
"active": false,
"failure_count": 0,
"last_status_code": 0,
"last_attempt_at": "2026-01-01T00:00:00.000Z",
"auto_disabled_at": "2026-01-01T00:00:00.000Z",
"first_failure_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z",
"secret_set": false
}