Update a webhook endpoint

PATCH

/v1/webhooks/:id

Changes a saved endpoint in place, keeping its id.

url — re-point it somewhere else.
events — re-filter which types it receives.
disabled: true — pause deliveries without losing the endpoint.

1 { "disabled": true }

Runs already in flight pick the change up immediately: they hold the whe_ reference, not a URL snapshot. Rotating an endpoint mid-run reroutes the rest of that run’s deliveries.

Learn more: Webhooks guide

Changes a saved endpoint in place, keeping its id. - `url` — re-point it somewhere else. - `events` — re-filter which types it receives. - `disabled: true` — pause deliveries without losing the endpoint. ```json { "disabled": true } ``` <Note> Runs already in flight pick the change up immediately: they hold the `whe_` reference, not a URL snapshot. Rotating an endpoint mid-run reroutes the rest of that run's deliveries. </Note> **Learn more:** [Webhooks guide](https://docs.cloudraker.com/developers/webhooks)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired>=1 character

Request

This endpoint expects an object.

urlstringOptionalformat: "uri"

eventslist of enumsOptional

disabledbooleanOptional

Response

The updated endpoint.

object"webhook_endpoint"

idstring

urlstring

disabledboolean

createdAtstring

eventslist of strings

Errors

404

Not Found Error

429

Too Many Requests Error

$	curl -X PATCH https://api.cloudraker.com/v1/webhooks/id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"object": "webhook_endpoint",
3	"id": "whe_01JQ8ZKMRT4V6WXYZ0ABCDEFGH",
4	"url": "https://hooks.example.com/cloudraker",
5	"disabled": true,
6	"createdAt": "2024-05-20T12:45:00Z",
7	"events": [
8	"run.completed",
9	"file.processed"
10	]
11	}