---
title: Update a webhook
description: Changes the name, URL, event types, buckets, or enabled.
doc_version: 0.1.0-preview
last_updated: 2026-09-14
---

# 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.

## Authentication

Send `Authorization: Bearer <GRAPHON_API_KEY>`. Read the key from the
GRAPHON_API_KEY environment variable. Never print it.

## Path parameters

- `workspaceId` (string) — The workspace id.
- `webhookId` (string) — The webhook id.

## Request body

- `name` (string (optional)) — Display name.
- `url` (string (optional)) — The receiver URL.
- `eventTypes` (string[] (optional)) — Event types to send, or null for every type.
- `bucketIds` (string[] (optional)) — Buckets whose events to send, or null for every bucket.
- `enabled` (boolean (optional)) — false turns the webhook off and ends its pending deliveries. true turns it on for later events.

## Example request

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

## CLI

```bash
graphon webhooks update whkN4vB7qX2mZ --disable
```

## Example 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"
}
```

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.