<!-- https://cutedyno.com/docs/api/update-webhook -->

# Update a webhook subscription

`PATCH https://api.cutedyno.com/v1/webhooks/{id}`

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.

Required permission: `webhooks:write`

## Path parameters

- `id` (string, required) — Webhook subscription id.

## Body

- `profileId` (string) — Profile to act on. Defaults to the profile the API key was created in.
- `url` (string) — HTTPS endpoint that receives POSTs.
- `events` (enum[]) — Replaces the current event list.
- `isActive` (boolean) — Set false to stop delivering without deleting.

## Request

```bash
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
}'
```

```typescript
import { CuteDyno } from '@cutedyno/node';

const cutedyno = new CuteDyno();

const result = await cutedyno.request('PATCH', '/v1/webhooks/{id}');
console.log(result);
```

```python
import os
import requests

url = "https://api.cutedyno.com/v1/webhooks/WEBHOOK_ID"
headers = {"Authorization": f"Bearer {os.environ['CUTEDYNO_API_KEY']}"}

payload = {
    "profileId": "profile_a1b2c3d4",
    "url": "https://cdn.example.com/media/launch.jpg",
    "events": [
        "account.connected"
    ],
    "isActive": False
}

response = requests.patch(url, json=payload, headers=headers)
response.raise_for_status()
print(response.json())
```

## Response 200

- `subscription` (WebhookSubscription, required)

```json
{
  "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

- `invalid_request` (400) — The request body or query string failed validation. The message names the offending field.
- `invalid_api_key` (401) — The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
- `not_found` (404) — The resource does not exist inside the resolved profile.
- `rate_limit_exceeded` (429) — Too many requests for this key. Honour the Retry-After header before retrying.
- `internal_error` (500) — Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.