Update an event destination
to try read requests with your account, or paste an API key into the Authorization field. Create an API key in the Partner Portal.
Changes an event destination's name, url, or both. A new url applies to subsequent deliveries; the bearer secret stays the same.
Returns the updated destination. Returns 404 when the destination does not exist or belongs to another organization.
destinationId*stringEvent destination id
^whk_[0-9A-HJKMNP-TV-Z]{26}$application/json- body
Partial update of an event destination. At least one of name or url is required.
name*stringHuman-readable label for this destination within the organization.
1 <= length <= 128url*stringPublic HTTPS endpoint that will receive event deliveries. Plain HTTP is rejected.
^((%[0-9A-Fa-f]{2}|[-()_.!~*';/?:@&=+$,A-Za-z0-9])+)([).!';/?:,])?$length <= 2048The updated event destination
application/json- response
HTTPS endpoint registered for outbound event delivery. Scoped to the authenticated organization.
destinationId*stringStable destination id. Client-supplied at create, or server-generated when omitted.
^whk_[0-9A-HJKMNP-TV-Z]{26}$name*stringHuman-readable label for this destination within the organization.
1 <= length <= 128url*stringPublic HTTPS endpoint that will receive event deliveries. Plain HTTP is rejected.
^((%[0-9A-Fa-f]{2}|[-()_.!~*';/?:@&=+$,A-Za-z0-9])+)([).!';/?:,])?$length <= 2048createdAt*stringWhen the destination was registered
date-timeupdatedAt*stringWhen the destination name or URL last changed
date-timebearerAuthAuthorizationBearer <token>curl -X PATCH 'https://api.prets.app/v1/events/destinations/whk_01ARZ3NDEKTSV4RRFFQ69G5FAV' \ -H 'Content-Type: application/json' \ -d '{ "name": "Production", "url": "https://example.com/prets/events"}'{ "destinationId": "whk_01ARZ3NDEKTSV4RRFFQ69G5FAV", "name": "Production", "url": "https://example.com/prets/events", "createdAt": "2026-06-01T12:00:00.000Z", "updatedAt": "2026-06-01T12:00:00.000Z"}