Escalations

Read one escalation (the wait-for-human loop)

Poll this until status is acknowledged — that is a named human taking ownership, with acknowledged.by_email and .channel. Then proceed per their direction, or stand down. Auth: SIWX wallet, control-plane session, or a run402_agent_key grant key. A project service_key is REJECTED — an escalation is agent judgement and needs a principal to attribute. Deny is 403, never 404. NEVER lifecycle-gated: an org in grace is exactly when an agent may most need a human.

get/orgs/v1/{org_id}/escalations/{escalation_id}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/orgs/v1/{org_id}/escalations/{escalation_id}
  • Auth: none declared

Path parameters

org_idstring uuid required

The organization whose hotline this is.

escalation_idstring uuid required

The escalation.

Query parameters

include'delivery'

include=delivery adds delivery_attempts[] read from the delivery audit log (per contact and channel). Opt-in: the wait-for-human poll is the hot path and must not pay for an audit scan it rarely reads.

Response

The escalation.

escalation_idstring uuid
org_idstring uuid
project_idstring nullable

Soft reference — the escalation outlives the project's deletion.

severity'normal' | 'high'
reasonstring

The agent's argument, verbatim. Rendered as DATA everywhere it is shown. For a rule raise, the platform's composed account of the event or window: what happened, where, the bounded facts, and who set the rule.

attached_countinteger

event-attention-rules: further matches of the raising rule that joined this escalation while it was open or acknowledged, instead of paging again. Always 0 for an agent raise.

last_attached_atstring date-time nullable
detailsobject

Structured sidecar. Readable here; never rendered into a page.

status'open' | 'acknowledged' | 'resolved'
levelinteger

Which contact level is currently paged.

raised_atstring date-time
deadline_atstring date-time

When an unacknowledged escalation climbs to the next level.

repage_countinteger

Top-level re-pages so far. At the bound the row rests OPEN — never auto-resolved.

Changes

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