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

# Update Webhook

> Update an existing webhook's URL, events, description, or active status.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

<ParamField body="id" type="string" required>
  The webhook ID to update.
</ParamField>

<ParamField body="url" type="string" required>
  The updated HTTPS URL.
</ParamField>

<ParamField body="events" type="string[]">
  Updated list of subscribed event types.
</ParamField>

<ParamField body="description" type="string">
  Updated description.
</ParamField>

<ParamField body="is_active" type="boolean">
  Set to `false` to pause deliveries without deleting the webhook.
</ParamField>

### Example request

```bash theme={"dark"}
curl -X PUT https://encrata.com/api/webhooks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "id": "360cb300-d885-4c18-af2c-d259f936bb38",
    "url": "https://example.com/webhook-v2",
    "events": ["lookup.completed"],
    "description": "Updated webhook",
    "is_active": true
  }'
```

## Response

### Example response

```json theme={"dark"}
{
  "status": "updated"
}
```