Skip to content

List incidents

What you can call today

Every example here runs against api.xovris.ai with a key from your account’s settings. GET /v1/health and GET /v1/public/status answer without one.

GET
/v1/incidents
curl --request GET \  --url https://api.xovris.ai/v1/incidents \  --header 'Authorization: Bearer <token>'

A token that can read is enough.

Done.

Media typeapplication/json
object
waitingOnYou
required
object
count
required
number
ids
required
Array<string>
toApprove
required
number
toActOn
required
number
needsYou
required
object
count
required
number
byKind
required
object
request
required
number
incident
required
number
stopped
required
number
items
required
Array<object>
object
kind
required
string
Allowed values: request incident stopped
id
required
string
title
required
string
since
required
One of:
string
href
required
string
approve
required
boolean
incidents
required
object
count
required
number
ids
required
Array<string>
toApprove
required
number
toActOn
required
number
items
required
Array<object>
object
id
required
kind
required
kindId
required
string
Allowed values: email domain api website ai server phone logs status_page people security cloud code family payment account app storage system network backup computer traces monitoring database job smart_home peripheral messaging work_tools customers
title
required
severity
required
state
required
outcome
required
statusLine
required
string
assetRef
required
release
required
openedAt
required
One of:
string
closedAt
required
One of:
string
triage
required
One of:
object
snoozed
required
One of:
object
until
required
One of:
string
untilWorse
required
boolean
untilActivity
required
boolean
by
required
string
at
required
string
words
required
string
woke
required
One of:
object
at
required
One of:
string
because
required
string
Allowed values: person time worse activity
words
required
string
muted
required
One of:
object
until
required
string
by
required
string
at
required
string
words
required
string
mergedInto
required
One of:
object
id
required
string
by
required
string
at
required
string
mergedFrom
required
Array<string>
owner
required
One of:
string
watchers
required
Array<string>
acked
required
One of:
object
by
required
string
at
required
string
from
required
string
Allowed values: push email phone app slack teams centre toast
words
required
string
pinnedBy
required
Array<string>
latest
required
One of:
object
type
required
string
at
required
string
sentence
required
One of:
string
title
required
One of:
string
headline
required
One of:
string
reason
required
One of:
string
to
One of:
string
label
required
One of:
string
state
required
One of:
string
text
required
One of:
string
sightings
One of:
object
n
required
number
firing
required
number
customersAffected
One of:
number
routed
One of:
object
memberId
required
string
via
required
string
at
required
string
email
required
One of:
string
next
required
One of:
object
at
required
string
step
required
number
policy
required
string
memberId
required
One of:
string
email
required
One of:
string
resolvedBefore
object
memberId
required
string
n
required
number
race
Array<object>
object
id
required
string
title
required
string
status
required
string
repairs
required
Array<object>
object
id
required
string
title
required
string
state
required
string
outcome
required
One of:
string
humanDescription
required
One of:
object
changes
required
string
where
required
string
undo
required
string
check
required
string
cause
required
One of:
object
headline
required
string
proof
required
string
Allowed values: confirmed likely
by
required
string
Allowed values: records checks
faultClass
required
One of:
string
times
required
object
detected
required
One of:
string
causeConcluded
required
One of:
string
fixReady
required
One of:
string
approved
required
One of:
string
changeStarted
required
One of:
string
changed
required
One of:
string
proved
required
One of:
string
putBack
required
One of:
string
stage
required
object
id
required
string
Allowed values: fixed investigating needs_you fixing fix_ready put_back closed_unproven proving restored_unproven cause_found
words
required
string
waitsOn
required
string
Allowed values: xovris you nobody
cause
required
string
Allowed values: none confirmed likely
proven
required
string
Allowed values: fix nothing cause
approve
required
One of:
string
press
required
One of:
object
kind
required
string
Allowed values: approve choose access
label
required
string
left
required
string
xos
required
object
xos
required
number
Allowed values: 1
kind
required
string
Allowed values: page report fix change answer alert tile
received_at
required
string
verdict
required
object
state
required
string
Allowed values: unknown fixed stale broken healthy working needs_you at_risk
text
required
string
targets
required
Array<object>
object
type
required
string
Allowed values: email domain dns website security cloud code device app network identity
id
required
string
claims
required
Array<object>
object
id
required
string
text
required
string
support
required
string
Allowed values: verified contradicted unchecked
evidence
required
Array<string>
evidence
required
Array<object>
object
id
required
string
kind
required
string
Allowed values: query video log diff measurement trace screenshot citation
source
required
string
captured_at
required
string
ttl_s
required
number
rerun
required
string
sha256
string
excerpt
string
checked
string
found
string
outcome
string
Allowed values: refutes inconclusive supports
confidence
required
object
tier
required
string
Allowed values: high medium low
reasons
required
Array<string>
would_raise
required
Array<string>
alternatives
required
Array<object>
object
cause
required
string
status
required
string
Allowed values: confirmed ruled_out possible
evidence
required
Array<string>
record
One of:
object
right
required
number
n
required
number
lower
required
number
plan
required
Array<object>
object
step
required
string
status
required
string
Allowed values: done failed active pending skipped
actions
required
Array<object>
object
id
required
string
label
required
string
consequence
required
string
reach
required
Array<string>
reversible
required
string
Allowed values: yes partly no
undo
required
One of:
object
method
required
string
window
required
string
cost
required
string
permission
required
string
Allowed values: ask auto deny
explains
object
changes
required
string
where
string
undo
string
primary
boolean
href
string
proof
required
One of:
object
before
required
object
metric
required
string
value
required
string
after
required
object
metric
required
string
value
required
string
method
required
string
verified_at
required
string
replay
string
verification
required
One of:
object
state
required
string
Allowed values: verified reverted unverified
check
required
string
output
string
why
string
at
required
string
undo_receipt
required
One of:
object
checkpoint
required
string
at
required
string
covers
required
Array<string>
does_not_cover
required
Array<string>
timeline
required
Array<object>
object
t
required
string
type
required
string
Allowed values: error result action needs_you thought
text
required
string
body
required
Array<object>
object
id
required
string
Allowed values: changed why found left checked
text
required
string
changes
required
Array<object>
object
group
required
string
explanation
required
string
target
required
string
rows
required
Array<object>
object
before
required
One of:
string
after
required
One of:
string
moved
boolean
impact
string
status
string
agent
required
string
Allowed values: Xovris
nextCursor
required
One of:
string
version
string

Example

{  "waitingOnYou": {    "count": 1,    "ids": [      "string"    ],    "toApprove": 1,    "toActOn": 1  },  "needsYou": {    "count": 1,    "byKind": {      "request": 1,      "incident": 1,      "stopped": 1    },    "items": [      {        "kind": "request",        "id": "string",        "title": "string",        "since": "string",        "href": "string",        "approve": true      }    ],    "incidents": {      "count": 1,      "ids": [        "string"      ],      "toApprove": 1,      "toActOn": 1    }  },  "items": [    {      "id": null,      "kind": null,      "kindId": "email",      "title": null,      "severity": null,      "state": null,      "outcome": null,      "statusLine": "string",      "assetRef": null,      "release": null,      "openedAt": "string",      "closedAt": "string",      "triage": {        "snoozed": {          "until": "string",          "untilWorse": true,          "untilActivity": true,          "by": "string",          "at": "string",          "words": "string"        },        "woke": {          "at": "string",          "because": "person",          "words": "string"        },        "muted": {          "until": "string",          "by": "string",          "at": "string",          "words": "string"        },        "mergedInto": {          "id": "string",          "by": "string",          "at": "string"        },        "mergedFrom": [          "string"        ],        "owner": "string",        "watchers": [          "string"        ],        "acked": {          "by": "string",          "at": "string",          "from": "push",          "words": "string"        },        "pinnedBy": [          "string"        ]      },      "latest": {        "type": "string",        "at": "string",        "sentence": "string",        "title": "string",        "headline": "string",        "reason": "string",        "to": "string",        "label": "string",        "state": "string",        "text": "string"      },      "sightings": {        "n": 1,        "firing": 1      },      "customersAffected": 1,      "routed": {        "memberId": "string",        "via": "string",        "at": "string",        "email": "string",        "next": {          "at": "string",          "step": 1,          "policy": "string",          "memberId": "string",          "email": "string"        }      },      "resolvedBefore": {        "memberId": "string",        "n": 1      },      "race": [        {          "id": "string",          "title": "string",          "status": "string"        }      ],      "repairs": [        {          "id": "string",          "title": "string",          "state": "string",          "outcome": "string",          "humanDescription": {            "changes": "string",            "where": "string",            "undo": "string",            "check": "string"          }        }      ],      "cause": {        "headline": "string",        "proof": "confirmed",        "by": "records",        "faultClass": "string"      },      "times": {        "detected": "string",        "causeConcluded": "string",        "fixReady": "string",        "approved": "string",        "changeStarted": "string",        "changed": "string",        "proved": "string",        "putBack": "string"      },      "stage": {        "id": "fixed",        "words": "string",        "waitsOn": "xovris",        "cause": "none",        "proven": "fix",        "approve": "string",        "press": {          "kind": "approve",          "label": "string"        },        "left": "string"      },      "xos": {        "xos": 1,        "kind": "page",        "received_at": "string",        "verdict": {          "state": "unknown",          "text": "string"        },        "targets": [          {            "type": "email",            "id": "string"          }        ],        "claims": [          {            "id": "string",            "text": "string",            "support": "verified",            "evidence": [              "string"            ]          }        ],        "evidence": [          {            "id": "string",            "kind": "query",            "source": "string",            "captured_at": "string",            "ttl_s": 1,            "rerun": "string",            "sha256": "string",            "excerpt": "string",            "checked": "string",            "found": "string",            "outcome": "refutes"          }        ],        "confidence": {          "tier": "high",          "reasons": [            "string"          ],          "would_raise": [            "string"          ],          "alternatives": [            {              "cause": "string",              "status": "confirmed",              "evidence": [                "string"              ]            }          ],          "record": {            "right": 1,            "n": 1,            "lower": 1          }        },        "plan": [          {            "step": "string",            "status": "done"          }        ],        "actions": [          {            "id": "string",            "label": "string",            "consequence": "string",            "reach": [              "string"            ],            "reversible": "yes",            "undo": {              "method": "string",              "window": "string"            },            "cost": "string",            "permission": "ask",            "explains": {              "changes": "string",              "where": "string",              "undo": "string"            },            "primary": true,            "href": "string"          }        ],        "proof": {          "before": {            "metric": "string",            "value": "string"          },          "after": {            "metric": "string",            "value": "string"          },          "method": "string",          "verified_at": "string",          "replay": "string"        },        "verification": {          "state": "verified",          "check": "string",          "output": "string",          "why": "string",          "at": "string"        },        "undo_receipt": {          "checkpoint": "string",          "at": "string",          "covers": [            "string"          ],          "does_not_cover": [            "string"          ]        },        "timeline": [          {            "t": "string",            "type": "error",            "text": "string"          }        ],        "body": [          {            "id": "changed",            "text": "string"          }        ],        "changes": [          {            "group": "string",            "explanation": "string",            "target": "string",            "rows": [              {                "before": null,                "after": null,                "moved": true              }            ]          }        ],        "impact": "string",        "status": "string",        "agent": "Xovris"      }    }  ],  "nextCursor": "string",  "version": "string"}

Not signed in: the token is missing, expired or revoked. The answer says how to get a new one.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Signed in, but this token or role may not do this. The answer names the permission it needs.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Nothing with that id here, or it belongs to another workspace. Nothing was changed.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Any other refusal or failure. The answer says what happened and what to do next.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Ask Xovris

Open the full page

Your data is never used to train our AI. How your data is kept

A problem is called fixed only once it works again. How each fix is checked

XOVRIS LTD, registered in England and Wales, company number 17499910. Registered office: 66 Paul Street, London EC2A 4NA.