curl --request POST \
--url https://api.dashboard.knotapi.com/webhook-endpoints/{id}/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"environment": "development",
"url": "https://example.com/webhooks/knot-v2"
}
'{
"id": "0a8f5c6e-3d2b-4e1a-9f7c-8b6d5e4c3a21",
"url": "https://example.com/webhooks/knot-v2",
"description": "Primary webhook listener",
"environment": "development",
"created_at": "2026-10-01T14:32:08Z"
}Update Webhook Endpoint
Update a webhook endpoint’s URL or description.
curl --request POST \
--url https://api.dashboard.knotapi.com/webhook-endpoints/{id}/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"environment": "development",
"url": "https://example.com/webhooks/knot-v2"
}
'{
"id": "0a8f5c6e-3d2b-4e1a-9f7c-8b6d5e4c3a21",
"url": "https://example.com/webhooks/knot-v2",
"description": "Primary webhook listener",
"environment": "development",
"created_at": "2026-10-01T14:32:08Z"
}Authorizations
Short-lived access token from the device authorization flow. Expires after 15 minutes. Manages only the environment of the client ID it was issued for.
Path Parameters
Unique identifier for the webhook endpoint.
"0a8f5c6e-3d2b-4e1a-9f7c-8b6d5e4c3a21"
Body
The input parameters required for updating a webhook endpoint. Include at least one of url or description.
The environment the webhook endpoint belongs to. Must match your access token's environment.
development, production "development"
The new URL. Must be a public https URL. Max 2083 characters.
"https://example.com/webhooks/knot-v2"
The new description, or null to remove it. Max 255 characters.
"Webhook listener v2"
Response
Successful request.
Unique identifier for the webhook endpoint.
"0a8f5c6e-3d2b-4e1a-9f7c-8b6d5e4c3a21"
The URL Knot sends webhooks to.
"https://example.com/webhooks/knot"
A description of the webhook endpoint, or null if none.
"Primary webhook listener"
The environment the webhook endpoint belongs to.
development, production "development"
When the webhook endpoint was created, in ISO 8601 format.
"2026-10-01T14:32:08Z"
Was this page helpful?