Kalpana Docs

PATCH /api/webhooks/{id}

Requires webhooks:update. Turning an endpoint on also needs an active subscription.

Send only the fields to change.

Name	Type	Required	Description
`workspace`	string	Yes	Workspace slug or id.
`name`	string	No	1 to 100 characters.
`description`	string	No	Up to 500 characters, or `null` to clear it.
`url`	string	No	A new URL, with the same rules as Add an endpoint.
`events`	string[]	No	1 to 20 event types, or `["*"]`. Replaces the list.
`filters`	object	No	`{ "templateIds": [...] }`, up to 50 template ids. Send `{}` to remove the filter.
`format`	string	No	`json`, `slack`, `discord` or `google_chat`.
`authHeader`	object	No	`{ "name": "...", "value": "..." }`, or `null` to remove it. Omit to keep it.
`enabled`	boolean	No	`false` turns the endpoint off. `true` turns it back on and clears its failure history.

curl --request PATCH "https://app.kalpana.one/api/webhooks/0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11" \
  --header "x-api-key: $KALPANA_API_KEY" \
  --header "content-type: application/json" \
  --data '{"workspace":"acme","enabled":false}'

Response

The updated endpoint object.

{
  "id": "0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11",
  "name": "Zapier: new creatives",
  "description": null,
  "url": "https://hooks.zapier.com/hooks/catch/123/abc/",
  "events": ["batch.completed"],
  "filters": {},
  "format": "json",
  "apiVersion": "2026-10-20",
  "authHeaderName": null,
  "source": "api",
  "enabled": false,
  "disabledAt": "2026-10-21T08:15:00.000Z",
  "disabledReason": "Turned off by a workspace member",
  "health": { "consecutiveFailures": 0, "failingSince": null },
  "createdAt": "2026-10-20T09:41:07.512Z",
  "updatedAt": "2026-10-21T08:15:00.000Z"
}

Changing the auth header keeps the signing secret. source and apiVersion cannot be changed.

Errors

Status	Cause
`400`	A field is not valid, such as an unknown event type or a URL that is not public `https`.
`402`	`enabled` is `true` on an endpoint that was off, and the organization has no active subscription.
`403`	Your role or key lacks `webhooks:update`.
`404`	The endpoint is not in this workspace.
`409`	Another endpoint already sends to the new `url`.

Change an endpoint

Response

Errors

On this page