Docs

Type a word or a question. Esc closes the search.

Sign in Start free

Get an alert plan test run

Returns the selected alert plan test run, or no content when none is available.

GET https://app.upfour.io/v1/escalation-policies/{policyID}/test-runs/{runID}
GET https://app.upfour.io/v1/escalation-policies/{policyID}/test-runs/{runID}
Authorization
AuthorizationA pls_ key. It stays in this browser tab. Needs escalation_policy.read.
Path

Sent directly from your browser to https://app.upfour.io/v1. Mutating calls get an automatic Idempotency-Key when the field is empty.

Request
Responsenot sent yet
Fill in a key and press Send request (⌘↵).
The answer appears here.
scope escalation_policy.read stable returns 200

Parameters

FieldTypeDescription
policyID required uuid path parameter
runID required uuid path parameter

Returns

A successful request returns 200 with application/json.

Response fields 1 top-level fields
FieldTypeDescription
data EscalationPolicyTestRun
EscalationPolicyTestRun · 22 fields
FieldTypeDescription
created_at string (date-time)
id uuid
mode string one ofstepfull
policy_id uuid
status string one ofscheduledin_progressdeliveredfailed
steps EscalationPolicyTestStep[] · nullable
Each item · 16 fields
FieldTypeDescription
position integer Zero-based position of the step within the plan.
scheduled_at string (date-time)
status string one ofscheduledin_progressdeliveredfailed
targets EscalationPolicyTestTarget[] · nullable
Each item · 10 fields
FieldTypeDescription
attempts integer
channel_id uuid Nil UUID for a rotation that reached nobody.
channel_name string
channel_type string
status string one ofscheduledin_progressdeliveredfailedunresolved
error string
person_name string Who was on call for the rotation when the test started.
reason string one ofnobody_on_callno_alert_channelrotation_unavailable
rotation_id uuid The rotation this channel was reached through, if any.
rotation_name string
urgency string one ofhighlowsmsvoice
wait_seconds integer

Errors

Only the errors this operation can return. Every error uses the same envelope.

Status Code Meaning
400 bad_request The request is malformed or fails validation.
404 not_found The requested resource does not exist or is outside the caller's scope.

Every call can also return unauthorized (401), rate_limit_exceeded (429) or internal_error (500 / 502). See Responses and errors.