Update a webhook endpoint
curl --request PATCH \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"url": "<string>",
"description": {},
"events": [
"<string>"
],
"brandIds": [
"<string>"
],
"enabled": true
}
'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}"
payload = {
"url": "<string>",
"description": {},
"events": ["<string>"],
"brandIds": ["<string>"],
"enabled": True
}
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
url: '<string>',
description: {},
events: ['<string>'],
brandIds: ['<string>'],
enabled: true
})
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Webhook endpoints
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.
PATCH
https://www.qwairy.co
/
api
/
v1
/
webhooks
/
{webhookId}
Update a webhook endpoint
curl --request PATCH \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"url": "<string>",
"description": {},
"events": [
"<string>"
],
"brandIds": [
"<string>"
],
"enabled": true
}
'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}"
payload = {
"url": "<string>",
"description": {},
"events": ["<string>"],
"brandIds": ["<string>"],
"enabled": True
}
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
url: '<string>',
description: {},
events: ['<string>'],
brandIds: ['<string>'],
enabled: true
})
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));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 and Writing data.
Supply at least one field.
See Error codes for authentication, plan, idempotency and server errors. A token without write access returns
The
ETag from Get a webhook endpoint, including its quotes. Use * to write unconditionally.Complete replacement list of event types, at least one.
Complete replacement list of at most 100 workspaces. An empty array receives the events of every workspace.
Response
Returns200, the new ETag and the endpoint, with the fields described in
List webhook endpoints.
Synthetic request and response
This example assumes theETag you last read is "0".
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}'
{
"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 |
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.
