webhooks

Re-run webhook ownership verification

Re-send the signed webhook.verify ownership challenge to a PENDING webhook's url and, if the endpoint now echoes data.token in a 2xx, flip it active — IN PLACE (id + secret preserved; no delete/recreate). Use it to recover after fixing a receiver that failed the challenge at create time. An already-verified webhook returns status:"active" unchanged (idempotent). Returns the same { status, verification? } shape as create.

post/v1/webhooks/{id}/verify

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/webhooks/{id}/verify
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: webhooks:write)
    • API key in header PAYMENT-SIGNATURE

Path parameters

idstring required

Response

Verification result (active if the challenge was echoed).

idstring required
status'active' | 'pending' required

active = ownership verified + receiving events; pending = challenge not echoed.

Changes

No recorded changes to this operation across all 1 revision of this API.