API reference

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

idstringrequired

Webhook subscription id.

Body

profileIdstringoptional

Profile to act on. Defaults to the profile the API key was created in.

urlstringoptional

HTTPS endpoint that receives POSTs.

eventsenum[]optional

Replaces the current event list.

isActivebooleanoptional

Set 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.

StatusCodeWhen it happens
400invalid_requestThe request body or query string failed validation. The message names the offending field.
401invalid_api_keyThe key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
404not_foundThe resource does not exist inside the resolved profile.
429rate_limit_exceededToo many requests for this key. Honour the Retry-After header before retrying.
500internal_errorSomething failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.