---
title: List webhooks
description: Lists the webhooks the caller can see, newest first.
doc_version: 0.1.0-preview
last_updated: 2026-09-14
---

# List webhooks

`GET /v1/workspaces/{workspaceId}/webhooks`

Lists the webhooks the caller can see, newest first. A member sees their own, a workspace key sees workspace webhooks, and an Admin sees every webhook. Signing secrets are never returned.

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

## Query parameters

- `owner` (string (optional)) — Narrows the list. Without it, a member sees their own webhooks, a workspace key sees workspace webhooks, and an Admin sees every webhook. One of: me, workspace.

## Example request

```bash
curl \
  --url "https://api.beta.graphon.ai/v1/workspaces/wspq7ws2np5l8z4/webhooks" \
  --header "Authorization: Bearer $GRAPHON_API_KEY"
```

## CLI

```bash
graphon webhooks list
```

## Example response

```json
{
  "items": [
    {
      "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.