1. Docs
  2. API Reference
  3. Update a webhook subscription

Update a webhook subscription

PATCH/portal/v1/accounts/{accountSlug}/applications/{appSlug}/environments/{envSlug}/webhooks/{id}

Authentication

  • Bearer Token Authorization

    JWT access token

Path Parameters

Name Required Type Description
idRequiredstring

Request body

  • urlstring
  • event_typesstring[]
  • descriptionstring
  • is_activeboolean

Code samples

cURLJavaScriptPythonGo
curl -X PATCH "https://api.canopy.dev/portal/v1/accounts/{accountSlug}/applications/{appSlug}/environments/{envSlug}/webhooks/value" \
  -H "Authorization: Bearer $CANOPY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "string",
    "event_types": [
      "string"
    ],
    "description": "string",
    "is_active": false
  }'

Responses

200 Webhook subscription updated
{
  "id": "string",
  "url": "string",
  "event_types": [
    "string"
  ],
  "description": "string",
  "is_active": false,
  "created_at": "2026-04-20T12:00:00.000Z"
}

application/json

  • idstring*
  • urlstring*
  • event_typesstring[]*
  • descriptionstring
  • is_activeboolean*
  • created_atstring (date-time)*
401 Invalid or expired token
403 This token is not authorized for this endpoint (wrong principal type — e.g., admin token on identity-only endpoint, or vice versa)
404 Webhook subscription not found

Returned object

On this page

Related endpoints

GETList webhook subscriptions
POSTCreate a webhook subscription
GETGet a webhook subscription
DELETEDelete a webhook subscription