> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a webhook endpoint

> Change the URL, the events, the description, or pause deliveries.

<ParamField path="id" type="string" required>The endpoint id.</ParamField>
<ParamField body="url" type="string">A new HTTPS URL.</ParamField>
<ParamField body="enabled_events" type="string[]">Replaces the list.</ParamField>

<ParamField body="description" type="string | null" />

<ParamField body="status" type="string">`active` or `disabled`. Disabled endpoints receive nothing until re-enabled.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.agentcard.sh/api/v2/webhook_endpoints/we_7h2k9p4m \
    -H "Authorization: Bearer $ORG_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"status": "disabled"}'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "id": "we_7h2k9p4m",
    "object": "webhook_endpoint",
    "url": "https://your.app/agentcard/webhooks",
    "enabled_events": ["vault.card_stored", "checkout_authorization.*"],
    "status": "disabled",
    "description": "Production checkout events",
    "created_at": "2026-09-07T17:00:00Z"
  }
  ```
</ResponseExample>