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_WEBHOOKSpermission. - 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.
Authorization
apiKey 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"}