Webhooks
Webhook endpointを取得
GET
/api/v1alpha1/webhooks/{webhook_id}1件のWebhook endpointを返します。signing secretは含まれず、作成時にのみ返されます。
- アクセス: alphaを有効にしたAPI keyと
MANAGE_WEBHOOKS権限。 - 見つからない場合: 他のワークスペースのendpointは、存在しない場合と意図的に区別できません。そのidが他者のものであることは分かりません。
idをGET /api/v1alpha1/webhooks/{webhook_id}/deliveriesに渡すと配信履歴を確認できます。
認証
apiKey 認証Bearer <token>
場所: header
パスパラメーター
webhook_id*string
登録済みWebhook endpointの識別子です。
レスポンスボディ
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"}