Skip to main content
GET
Read one incident

Authorizations

x-api-key
string
header
required

Optional API key for authentication (enabled via application.yaml)

Path Parameters

id
string
required

Response

The incident

id
string
kind
enum<string>
Available options:
tap_failure,
pipeline_failure,
stale,
volume,
schema_drift
resourceType
string
resource
string
openedAt
string
state
enum<string>
Available options:
open,
diagnosing,
proposed,
awaiting_approval,
executing,
verifying,
resolved,
failed,
abandoned
trigger
object

The signal that opened the incident. A pipeline_failure trigger carries pipelineToken, error, errorClass and failingStage (dq-script | transformation-script | loader | other — derived from exception classes, never row values).

steps
object[]
classification
string

transient | structural-script | structural-schema | credential | platform | needs-human. credential and platform are decided by the platform, not the model, and never carry actions.

proposal
object
aiCalls
integer
actionsTaken
integer
awaitingApprovalIds
string[]
revertToVersion
integer

Tap incidents — the tap version restored if verification fails

revertToScriptVersions
object

Pipeline incidents — script kind (dataQuality | transformation) to the script version recorded before the first action, restored if verification fails (0 = no history yet; restores version 1). Absent when nothing was regenerated.

closedAt
string
outcome
string
evidence
object

Computed by platform code, never by a model. Record deltas are percentages; null rates and DQ pass rates are fractions.

verdict
enum<string>

Copy of evidence.verdict; present only when the incident has evidence

Available options:
pending,
pass,
fail,
needs-human