Trawl API reference

Trawl API · Webhooks

patch/v1/workspaces/{workspace_id}/webhooks/{id}Auth

Update 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 · uuid

Id of the workspace.

id*string · uuid

Id of the webhook.

Request body

urlstring

New destination URL.

activeboolean

Pause/resume the webhook. Setting active=true clears auto-disable.

Response · 200 Updated webhook (secret masked).

id*string · uuid
workspace_id*string · uuid
url*string
active*boolean

Whether it receives events (`enabled` on the new routes).

failure_count*number

Failed deliveries in a row (`consecutive_failures` on the new routes).

last_status_code*number

HTTP status of the latest attempt.

last_attempt_at*string · date-time

When the latest attempt was made.

auto_disabled_at*string · date-time

Set when it was switched off automatically after sustained failures.

first_failure_at*string · date-time
created_at*string · date-time
secret_setboolean

Always 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
}