Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "result": "passed",
    "steps": {
      "webhook_delivered": true,
      "claimed": true,
      "message_posted": true,
      "resolved": true
    },
    "escalationId": "esc_test_9f21",
    "destinationId": "dest_7a2c",
    "destinationStatus": "active"
  }
}

Escalation

Run the destination handshake (go-live gate)

Prove the destination’s external agent can talk back and forth BEFORE it can go live. Opens a sandbox escalation (is_test), delivers a signed escalation.test webhook to the endpoint, and (synchronous-wait) polls until the connector claims → posts one message → resolves, or the deadline lapses. On a green run the destination flips to status='active' with lastVerifiedAt set; on a red run it stays unverified (an already-active destination regresses to unverified and emits escalation.destination.unavailable) with an actionable hint. Returns the step-by-step result either way — HTTP 200 for BOTH pass and fail (the call itself succeeded; the result field carries the verdict). The test works on ANY plan (setup precedes upgrade) and never touches a visitor or a wallet.

POST

escalation-destinations

{id}

test

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "result": "passed",
    "steps": {
      "webhook_delivered": true,
      "claimed": true,
      "message_posted": true,
      "resolved": true
    },
    "escalationId": "esc_test_9f21",
    "destinationId": "dest_7a2c",
    "destinationStatus": "active"
  }
}

Authorizations

Authorization

string

header

required

Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.

Path Parameters

string

required

The escalation-destination id to run the go-live handshake against.

Query Parameters

wait_seconds

integer

Bound the synchronous poll window (seconds). Defaults to the destination's claim SLA; hard cap 125s.

Required range: 0 <= x <= 125

Response

The handshake verdict (passed or failed) with the step ledger.

success

boolean

required

data

object

required

Show child attributes

message

string

errors

object[]

Show child attributes

Rotate the destination signing secret (new secret shown once)List escalations

Using the API

Endpoints

Run the destination handshake (go-live gate)

Authorizations

Path Parameters

Query Parameters

Response