v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB
Webhooks

Update Webhook

Update a webhook's events or scope. The targetUrl cannot be changed and is ignored if sent; the handshake is repeated against the existing URL to confirm it is still reachable. Send X-Skip-Handshake: 1 to skip it.

put/hooks/{hook_id}

Path parameters

hook_idnumber required
Example:280382

Webhook ID

Request body

eventsstring[] required

Replacement list of events. targetUrl and scope cannot be changed after creation.

Example request

{
  "events": [
    "api:time:updated"
  ]
}

Response

OK

idnumber required

Webhook ID

targetUrlstring required
eventsstring[] required
projectstring nullable

You can receive events only for specific project

activeboolean
createdAtstring required

Datetime when webhook was created (format: Y-m-d H:i:s)

lastUsedAtstring required

Datetime when webhook was last used (format: Y-m-d H:i:s)

Example response

{
  "id": 12345,
  "targetUrl": "https://some-secure-endpoint.com/path",
  "events": [
    "api:time:updated"
  ],
  "project": "ev:12345657890",
  "active": true,
  "createdAt": "2018-03-05 16:17:14",
  "lastUsedAt": "2018-03-05 20:01:58"
}