Skip to content

Read the owner's monthly report: what broke, what was fixed and what it saved

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/reports/owner
curl --request GET \  --url https://api.xovris.ai/v1/reports/owner \  --header 'Authorization: Bearer <token>'

A token that can read is enough.

Done.

Media typeapplication/json
object
month
required
string
broke
required
object
opened
required
number
bySeverity
required
object
high
required
number
medium
required
number
low
required
number
critical
required
number
stillOpen
required
number
incidents
required
Array<object>
object
id
required
string
title
required
string
severity
required
string
Allowed values: high medium low critical
openedAt
required
string
open
required
boolean
said
required
string
fixed
required
object
incidents
required
number
requests
required
number
other
required
number
prevented
required
number
said
required
string
saved
required
object
measured
required
number
hours
required
number
totalMinor
required
One of:
number
currency
required
One of:
string
paidForItself
required
One of:
number
said
required
string
recovered
required
object
amountMinor
required
One of:
number
currency
required
One of:
string
byCurrency
required
Array<object>
object
currency
required
string
amountMinor
required
number
items
required
Array<object>
object
id
required
string
kind
required
string
amountMinor
required
number
currency
required
string
recoveredAt
required
string
source
required
string
sourceRef
required
string
byXovris
required
boolean
how
required
string
byXovris
required
number
said
required
string
risk
required
object
score
required
One of:
number
before
required
One of:
number
change
required
One of:
number
said
required
string
decide
required
object
waiting
required
number
approvals
required
Array<object>
object
id
required
string
kind
required
string
since
required
string
incidents
required
Array<object>
object
id
required
string
title
required
string
since
required
string
tickets
required
Array<object>
object
id
required
string
vendor
required
string
subject
required
string
since
required
string
credits
required
Array<object>
object
provider
required
string
service
required
string
downMinutes
required
number
uptime
required
number
promise
required
number
creditPct
required
number
creditDays
required
One of:
number
claimBy
required
string
source
required
string
said
required
string
said
required
string
sentence
required
string

Example

{  "month": "string",  "broke": {    "opened": 1,    "bySeverity": {      "high": 1,      "medium": 1,      "low": 1,      "critical": 1    },    "stillOpen": 1,    "incidents": [      {        "id": "string",        "title": "string",        "severity": "high",        "openedAt": "string",        "open": true      }    ],    "said": "string"  },  "fixed": {    "incidents": 1,    "requests": 1,    "other": 1,    "prevented": 1,    "said": "string"  },  "saved": {    "measured": 1,    "hours": 1,    "totalMinor": 1,    "currency": "string",    "paidForItself": 1,    "said": "string"  },  "recovered": {    "amountMinor": 1,    "currency": "string",    "byCurrency": [      {        "currency": "string",        "amountMinor": 1      }    ],    "items": [      {        "id": "string",        "kind": "string",        "amountMinor": 1,        "currency": "string",        "recoveredAt": "string",        "source": "string",        "sourceRef": "string",        "byXovris": true,        "how": "string"      }    ],    "byXovris": 1,    "said": "string"  },  "risk": {    "score": 1,    "before": 1,    "change": 1,    "said": "string"  },  "decide": {    "waiting": 1,    "approvals": [      {        "id": "string",        "kind": "string",        "since": "string"      }    ],    "incidents": [      {        "id": "string",        "title": "string",        "since": "string"      }    ],    "tickets": [      {        "id": "string",        "vendor": "string",        "subject": "string",        "since": "string"      }    ],    "credits": [      {        "provider": "string",        "service": "string",        "downMinutes": 1,        "uptime": 1,        "promise": 1,        "creditPct": 1,        "creditDays": 1,        "claimBy": "string",        "source": "string",        "said": "string"      }    ],    "said": "string"  },  "sentence": "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.