Skip to main content
PATCH
/
v1
/
webhooks
/
{id}
curl --request PATCH \
  --url https://api.anchorbrowser.io/v1/webhooks/{id} \
  --header 'Content-Type: application/json' \
  --header 'anchor-api-key: <api-key>' \
  --data '
{
  "url": "https://new-host.example.com/anchor/webhooks"
}
'
{
  "id": "wh_01HXJ4MZ7K9P3Q6R8S2T4V5W7Y",
  "project_id": "5d2c31f6-ab7e-481a-b6fd-8b4a96a4e197",
  "url": "https://your-app.example.com/anchor/webhooks",
  "description": "Production task notifications",
  "subscribed_events": [],
  "enabled": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
anchor-api-key
string
header
required

API key passed in the header

Path Parameters

​
id
string
required

Webhook id.

Body

application/json

Partial update — only the fields you include are changed.

​
url
string<uri>
Required string length: 1 - 2048
​
description
string | null
Maximum string length: 256
​
subscribed_events
enum<string>[]
Minimum array length: 1

Catalog of webhook event types Anchor can deliver. Adding a new event type is a coordinated change between session-manager (publisher), webhook-dispatcher (consumer), and the dashboard.

Available options:
task.completed,
task.failed,
task.cancelled,
task.healed,
session.completed,
session.failed,
session.recording.ready,
batch.completed,
batch.failed,
intervention.requested,
intervention.resolved,
identity.authenticated,
identity.authentication_failed
​
enabled
boolean

Response

Webhook updated.

A registered webhook subscription. The signing secret is NEVER returned by GET/list endpoints.

​
id
string
required

Webhook id. Use as the path parameter on subsequent calls.

Example:

"wh_01HXJ4MZ7K9P3Q6R8S2T4V5W7Y"

​
project_id
string<uuid>
required

The project (team) the webhook belongs to.

Example:

"5d2c31f6-ab7e-481a-b6fd-8b4a96a4e197"

​
url
string<uri>
required

HTTPS URL Anchor will POST events to.

Example:

"https://your-app.example.com/anchor/webhooks"

​
description
string | null
required

Optional human-readable description.

Maximum string length: 256
Example:

"Production task notifications"

​
subscribed_events
enum<string>[]
required

Event types this webhook is currently subscribed to.

Catalog of webhook event types Anchor can deliver. Adding a new event type is a coordinated change between session-manager (publisher), webhook-dispatcher (consumer), and the dashboard.

Available options:
task.completed,
task.failed,
task.cancelled,
task.healed,
session.completed,
session.failed,
session.recording.ready,
batch.completed,
batch.failed,
intervention.requested,
intervention.resolved,
identity.authenticated,
identity.authentication_failed
​
enabled
boolean
required

When false, no events fan out to this webhook.

Example:

true

​
created_at
string<date-time> | null
required
​
updated_at
string<date-time> | null
required