Skip to main content
PATCH
/
api
/
v1
/
webhook_endpoints
/
{id}
curl -X PATCH https://api.agentcard.sh/api/v1/webhook_endpoints/wh_abc123 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled_events": ["card.*", "transaction.*"]}'

{
  "id": "wh_abc123",
  "object": "webhook_endpoint",
  "url": "https://your-app.example.com/webhooks/agentcard",
  "enabled_events": ["card.*", "transaction.*"],
  "status": "active",
  "description": "production receiver",
  "consecutive_failures": 0,
  "last_success_at": "2026-05-17T13:42:00.000Z",
  "disabled_at": null,
  "created_at": "2026-05-17T12:00:00.000Z",
  "updated_at": "2026-05-17T14:10:00.000Z"
}
Updates one or more fields on a webhook endpoint. All fields are optional — pass only what you want to change. Setting status: "active" on a previously auto-disabled endpoint clears the failure counter.

​
Request body

​
url
string
New endpoint URL.
​
enabled_events
array of strings
Replacement event-subscription list.
​
status
string
"active" or "disabled". Use "disabled" to temporarily pause deliveries without losing configuration.
​
description
string
New description.
curl -X PATCH https://api.agentcard.sh/api/v1/webhook_endpoints/wh_abc123 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled_events": ["card.*", "transaction.*"]}'

{
  "id": "wh_abc123",
  "object": "webhook_endpoint",
  "url": "https://your-app.example.com/webhooks/agentcard",
  "enabled_events": ["card.*", "transaction.*"],
  "status": "active",
  "description": "production receiver",
  "consecutive_failures": 0,
  "last_success_at": "2026-05-17T13:42:00.000Z",
  "disabled_at": null,
  "created_at": "2026-05-17T12:00:00.000Z",
  "updated_at": "2026-05-17T14:10:00.000Z"
}