PATCH
/v1/webhooks/{id}Update a webhook subscription
Changes the URL or event list, or pauses delivery with isActive: false. A paused subscription keeps its secret and its delivery history.
Required permission: `webhooks:write`
Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.
- Base URL
- https://api.cutedyno.com
- Permission
webhooks:write- Idempotency
- Not applicable. This request has no side effects worth deduplicating.
Request
curl -X PATCH "https://api.cutedyno.com/v1/webhooks/WEBHOOK_ID" \
-H "Authorization: Bearer $CUTEDYNO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profileId": "profile_a1b2c3d4",
"url": "https://cdn.example.com/media/launch.jpg",
"events": [
"account.connected"
],
"isActive": false
}'Path parameters
idstringrequiredWebhook subscription id.
Body
profileIdstringoptionalProfile to act on. Defaults to the profile the API key was created in.
urlstringoptionalHTTPS endpoint that receives POSTs.
eventsenum[]optionalReplaces the current event list.
isActivebooleanoptionalSet false to stop delivering without deleting.
Response
Returns 200 with the following body.
WebhookSubscriptionrequired
Example
{
"subscription": {
"id": "a1b2c3d4-0000-4000-8000-000000000000",
"url": "https://cdn.example.com/media/launch.jpg",
"events": [
"string"
],
"scope": "profile",
"isActive": false,
"createdAt": "string",
"updatedAt": "string"
}
}Errors
Failures use the standard error envelope. Branch on code, never on the message.
| Status | Code | When it happens |
|---|---|---|
| 400 | invalid_request | The request body or query string failed validation. The message names the offending field. |
| 401 | invalid_api_key | The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_. |
| 404 | not_found | The resource does not exist inside the resolved profile. |
| 429 | rate_limit_exceeded | Too many requests for this key. Honour the Retry-After header before retrying. |
| 500 | internal_error | Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists. |