Change a subscription
Needs the scope webhooks:manage
Change the URL or the event types of a subscription.
webhook_id*stringThe id from POST /api/v1/webhooks.
Format
uuidapplication/json- body
url?stringA new receiver address.
Match
^https:\/\/\S+$Length
length <= 2000events?array<>The event types to receive from now on. The same names as when you create a subscription.
OK
application/json- response
id*stringFormat
uuidurl*stringFormat
urievents*array<>active*booleansecretPrefix*stringThe first 12 characters of the signing secret, so you can tell secrets apart.
createdAt*stringFormat
date-timecurl -sS -X PATCH https://platform.charpstar.co/api/v1/webhooks/$WEBHOOK_ID \ -H "Authorization: Bearer $CHARPSTAR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "events": ["asset.approved", "status.changed"] }'Example Response
{ "id": "a1b2c3d4-0000-4000-8000-000000000001", "url": "https://example.com/charpstar/events", "events": [ "asset.approved", "status.changed" ], "active": true, "secretPrefix": "whsec_Q2x9Ab", "createdAt": "2026-10-20T08:00:00.000Z"}