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

# Update a webhook endpoint

> Change the URL, description, events, workspace filter or activation of an integration webhook endpoint. Re-enabling an endpoint clears its failure state.

Updates the URL, description, events, workspaces or activation of an endpoint.
Send only the fields you want to change. Re-enabling an endpoint that was
disabled for failures clears its failure state.

Integration webhooks require an active Business, Agency Business or Enterprise plan. Changing an endpoint also requires an API token with write access enabled by an Owner or Manager. See [Integration webhooks](https://docs.qwairy.co/developers/integration-webhooks/overview.md) and [Writing data](https://docs.qwairy.co/developers/writing-data.md).

**Authorization** `string` *required*

Bearer token for your team.

**If-Match** `string` *required*

The `ETag` from [Get a webhook endpoint](https://docs.qwairy.co/developers/endpoints/webhooks/get.md), including its quotes. Use `*` to write unconditionally.

**webhookId** `string` *required*

Endpoint identifier.

**url** `string`

Public HTTPS URL, at most 2048 characters.

**description** `string | null`

Free description, at most 200 characters, or `null` to clear it.

**events** `string[]`

Complete replacement list of [event types](https://docs.qwairy.co/developers/integration-webhooks/events.md), at least one.

**brandIds** `string[]`

Complete replacement list of at most 100 workspaces. An empty array receives the events of every workspace.

**enabled** `boolean`

`false` pauses delivery; `true` resumes it.

Supply at least one field.

## Response

Returns `200`, the new `ETag` and the endpoint, with the fields described in
[List webhook endpoints](https://docs.qwairy.co/developers/endpoints/webhooks/list.md).

## Synthetic request and response

This example assumes the `ETag` you last read is `"0"`.

```bash theme={null}
curl -X PATCH "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "0"' \
  -H "Content-Type: application/json" \
  -d '{"events":["run.completed","run.failed","run.cancelled"],"enabled":true}'
```

```json theme={null}
{
  "id": "eeeeeeee-0000-4000-8000-000000000000",
  "url": "https://hooks.example.com/qwairy",
  "description": "Production receiver",
  "events": ["run.completed", "run.failed", "run.cancelled"],
  "brandIds": [],
  "enabled": true,
  "disabledReason": null,
  "failingSince": null,
  "previousSecretExpiresAt": null,
  "version": 1,
  "createdAt": "2026-10-12T09:00:00.000Z",
  "updatedAt": "2026-10-12T10:00:00.000Z"
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | No field, or an invalid value |
| `404` | `RESOURCE_NOT_FOUND` | The endpoint is missing or belongs to another team |
| `412` | `PRECONDITION_FAILED` | The endpoint changed since your read |
| `428` | `PRECONDITION_REQUIRED` | `If-Match` is missing |

See [Error codes](https://docs.qwairy.co/developers/errors.md) for authentication, plan, idempotency and server errors. A token without write access returns `403 API_KEY_READ_ONLY`. On `429`, honor `Retry-After`. If the write limiter is unavailable or writes are suspended, the request returns `503 SERVICE_UNAVAILABLE` and nothing changes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.