Update a webhook

PATCH/v1/workspaces/{workspaceId}/webhooks/{webhookId}

Changes the name, URL, event types, buckets, or enabled. A member manages their own webhooks, a workspace key manages workspace webhooks, and an Admin manages every webhook.

View as Markdown

Authentication

Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.

Authorization: Bearer <GRAPHON_API_KEY>

curl --request PATCH \
  --url "https://api.beta.graphon.ai/v1/workspaces/wspq7ws2np5l8z4/webhooks/whkN4vB7qX2mZ" \
  --header "Authorization: Bearer $GRAPHON_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"url":"https://hooks.example.com/v2/graphon","eventTypes":null}'

Request

Loading your session…

Response

JSON

{
  "id": "whkN4vB7qX2mZ",
  "workspaceId": "wspq7ws2np5l8z4",
  "name": "indexing-callbacks",
  "url": "https://hooks.example.com/graphon",
  "eventTypes": [
    "object.indexed",
    "object.indexing_failed"
  ],
  "bucketIds": null,
  "enabled": true,
  "disabledReason": null,
  "ownerKind": "user",
  "ownerUserId": "usrB2c3D4e5F6",
  "signing": {
    "secretFingerprint": "sha256:9b2d44f0",
    "previousSecretFingerprint": null,
    "previousSecretExpiresAt": null
  },
  "delivery": {
    "pendingDeliveries": 0,
    "lastSucceededAt": "2026-10-14T09:05:13.004Z",
    "lastFailedAt": null
  },
  "createdBy": {
    "userId": "usrB2c3D4e5F6",
    "apiKeyId": null
  },
  "createdAt": "2026-10-14T09:00:00.000Z",
  "updatedAt": "2026-10-14T09:00:00.000Z"
}

Path parameters

workspaceIdstring

The workspace id.

webhookIdstring

The webhook id.

Request body

namestring (optional)

Display name.

urlstring (optional)

The receiver URL.

eventTypesstring[] (optional)

Event types to send, or null for every type.

bucketIdsstring[] (optional)

Buckets whose events to send, or null for every bucket.

enabledboolean (optional)

false turns the webhook off and ends its pending deliveries. true turns it on for later events.

Was this page helpful?