Skip to content
Webhooks

Get a webhook endpoint

GET/api/v1alpha1/webhooks/{webhook_id}

Returns one webhook endpoint. The signing secret is not included; it is shown only when the endpoint is created.

  • Access: an alpha-enabled API key with the MANAGE_WEBHOOKS permission.
  • Not found: an endpoint in another workspace is deliberately indistinguishable from one that does not exist, so this response never reveals that an id belongs to somebody else.

Use the id with GET /api/v1alpha1/webhooks/{webhook_id}/deliveries to see its delivery history.

AuthorizationBearer <token>

In: header

Path Parameters

webhook_id*string

Identifier of a registered webhook endpoint.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1alpha1/webhooks/wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" \  -H "Authorization: Bearer $DEEPFRAME_API_KEY"
{  "created_at": "2026-08-08T10:00:00.000Z",  "description": "Warehouse review pipeline",  "enabled": true,  "events": [    "video.indexed",    "run.completed"  ],  "id": "wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab",  "updated_at": "2026-08-08T10:09:00.000Z",  "url": "https://hooks.example.com/deepframe"}