Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

  • a Bifrost management API key,
  • a dashboard session token issued by POST /api/session/login,
  • base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

Path Parameters

id
string
required

The webhook endpoint id.

Body

application/json
event
enum<string>
required

The event to render for the sample delivery. Must be one the endpoint subscribes to.

Available options:
async_job.completed,
async_job.failed

Response

Test delivery attempted

delivered
boolean

True when the receiver answered with a 2xx status.

receiver_status_code
integer

The HTTP status the receiver returned. Present when the request reached the receiver.

error
string

Failure reason when the delivery could not be completed.