Skip to main content

Documentation index for AI agents: llms.txt. Every page here is also served as markdown: add .md to its address, or request it with Accept: text/markdown.

IncidentContext data model

Everything the incident detail view shows, in one read.

Fields

FieldTypeRequiredDescription
generatedAtstring (date-time)No
incidentobjectNo
incident.idstring (uuid)No
incident.titlestringNo
incident.descriptionstring or nullNo
incident.statestringNoOne of: ongoing, acknowledged, resolved.
incident.rawStatusstringNoStored status, for example INVESTIGATING or RESOLVED.
incident.startedAtstring (date-time)No
incident.detectedAtstring (date-time)No
incident.acknowledgedAtstring (date-time) or null (date-time)No
incident.acknowledgedByobject or nullNo
incident.acknowledgedBy.idstringNo
incident.acknowledgedBy.namestringNo
incident.resolvedAtstring (date-time) or null (date-time)No
incident.durationMsintegerNo
incident.autoResolvebooleanNo
incident.rootCausestring or nullNo
incident.resolutionstring or nullNo
incident.monitorIdstring (uuid) or null (uuid)No
incident.serverIdstring (uuid) or null (uuid)No
incident.visualTargetIdstring (uuid) or null (uuid)No
incident.metadataanyNoStored incident metadata (any JSON).
incident.severitystringNocritical, high, medium, low or info.
incident.incidentKindstring or nullNo
incident.reportedbooleanNoA person reported the incident.
incident.reportedByobject or nullNo
incident.reportedBy.idstringNo
incident.reportedBy.namestringNo
ownerstringNoOne of: uptime, ssl, performance, domain, content, visual, security, server, other.
checkTypestringNoOne of: other_address, uptime, ssl, domain, performance, content, visual, security, server, manual.
causestringNoOne of: other_address, http_error, checker_blocked, checker_rate_limited, timeout, dns, refused, down, certificate_expired, certificate_self_signed, certificate_mismatch, certificate_problem, ssl_expiring, ssl_expired, slow, performance, domain_expired, visual_change, content_failed, security, server, manual.
headlinestringNo
shortCausestring or nullNo
summaryobjectNo
summary.whatstringNo
summary.wherestring or nullNo
summary.nextstring or nullNo
stepsarray of stringNo
fixActionsarray of objectNoSuggested fixes. Empty unless your role is Owner, Admin or Developer.
fixActions[].kindstringYesOne of: ssl_check, settings_link, bot_page, server_link, mute.
fixActions[].enabledbooleanNossl_check only.
fixActions[].sectionstringNosettings_link only: monitor settings section id.
fixActions[].serverIdstringNoserver_link only.
fixActions[].labelstringNo
whatWeCheckedarray of objectNo
whatWeChecked[].labelstringNo
whatWeChecked[].valuestringNo
whatWeChecked[].atstring (date-time)NoOptional time to show after value.
settingsSectionstring or nullNoOne of: general, uptime, ssl, domain, visual, content, performance, dns, alerts, reports, server, danger, null.
monitorobject or nullNoNull for server incidents and when the monitor was deleted.
monitor.idstring (uuid)No
monitor.namestringNo
monitor.urlstringNo
monitor.enabledbooleanNo
monitor.checkIntervalintegerNo
monitor.timeoutintegerNo
monitor.alertThresholdintegerNo
monitor.maxResponseTimeintegerNo
monitor.locationsarray of stringNo
monitor.sslCheckbooleanNo
monitor.sslAlertDaysarray of integerNo
monitor.domainExpiryEnabledbooleanNo
monitor.domainAlertDaysarray of integerNo
monitor.notificationRepeatIntervalintegerNoMinutes until a reminder, then one a day; 0 sends no reminders.
monitor.alertsMutedUntilstring (date-time) or null (date-time)NoEnd of an active mute; null when alerts are live.
monitor.alertsMuteExemptbooleanNoTrue when a mute never holds back this incident's alerts (possible malware).
monitor.linkedChannelsarray of objectNo
monitor.linkedChannels[].idstring (uuid)No
monitor.linkedChannels[].namestringNo
monitor.linkedChannels[].typestringNo
monitor.linkedChannels[].enabledbooleanNo
serverobject or nullNo
server.idstring (uuid)No
server.namestringNo
server.statusstringNo
server.cpuUsagenumber or nullNo
server.memoryUsagenumber or nullNo
server.diskUsagenumber or nullNo
server.cpuCoresinteger or nullNo
server.loadAveragearray of number or nullNo
server.loadWarnRationumber or nullNo
server.loadCritRationumber or nullNo
server.agentLastSeenstring (date-time) or null (date-time)No
regionsarray of objectNo
regions[].regionstringNo
regions[].labelstringNo
regions[].failingbooleanNo
regions[].latestobject or nullNo
regions[].latest.atstring (date-time)No
regions[].latest.okbooleanNo
regions[].latest.regionalOnlybooleanNo
regions[].latest.resultstringNo
regions[].latest.statusCodeinteger or nullNo
checkLogobjectNoChecks from 15 minutes before the start to the resolution (or now). When the window holds more than 50 checks, the newest 50 and oldest 10 are returned and omitted counts the rest.
checkLog.windowStartstring (date-time)No
checkLog.windowEndstring (date-time)No
checkLog.rowsarray of objectNo
checkLog.rows[].idstringNo
checkLog.rows[].atstring (date-time)No
checkLog.rows[].regionstringNo
checkLog.rows[].regionLabelstringNo
checkLog.rows[].okbooleanNo
checkLog.rows[].regionalOnlybooleanNo
checkLog.rows[].statusCodeinteger or nullNo
checkLog.rows[].resultstringNo
checkLog.rows[].errorstring or nullNo
checkLog.rows[].errorCodestring or nullNo
checkLog.rows[].responseTimeMsnumber or nullNo
checkLog.omittedintegerNo
certificateobject or nullNo
certificate.validFromstring (date-time)No
certificate.validTostring (date-time)No
certificate.daysRemainingintegerNo
certificate.issuerstringNo
certificate.subjectstringNo
certificate.algorithmstringNo
certificate.keySizeintegerNo
certificate.altNamesarray of stringNo
visualDiffobject or nullNoBefore and after screenshots recorded with a visual incident.
visualDiff.astringNoBaseline image path.
visualDiff.bstringNoCapture image path.
visualDiff.diffstring or nullNo
visualDiff.percentnumberNo
visualDiff.thresholdnumber or nullNo
visualDiff.screenshotIdstringNo
visualDiff.visualTargetIdstring or nullNo
visualDiff.viewportstring or nullNoOne of: DESKTOP, MOBILE, null.
visualDiff.targetLabelstring or nullNo
visualDiff.exactbooleanNoOne of: true.
checksInRowobjectNo
checksInRow.countintegerNo
checksInRow.atLeastbooleanNoTrue when the stored log is cut short, so the real count may be higher.
uptimeTodayobject or nullNoThe monitor's day so far in the tz time zone (UTC when not given or not valid).
uptimeToday.percentnumber or nullNo
uptimeToday.downSecondsintegerNo
uptimeToday.sincestring (date-time)No
uptimeToday.slotsarray of stringNoItems are one of: ok, bad, none.
sentEventsarray of objectNoAlerts that went out, one per event.
sentEvents[].eventstringNoOne of: opened, reminder, recovered.
sentEvents[].atstring (date-time)No
sentEvents[].sentintegerNo
sentEvents[].failedintegerNo
sentEvents[].pendingintegerNo
sentEvents[].totalintegerNo
earlierOnMonitorarray of objectNoUp to three earlier resolved incidents of the same monitor.
earlierOnMonitor[].idstring (uuid)No
earlierOnMonitor[].titlestringNo
earlierOnMonitor[].sourcestringNo
earlierOnMonitor[].startedAtstring (date-time)No
earlierOnMonitor[].durationMsintegerNo
earlierOnMonitor[].checkTypestringNo
publicPreviewobject or nullNoWhat the first public status page showing this monitor says right now.
publicPreview.statusPageobjectNo
publicPreview.statusPage.idstring (uuid)No
publicPreview.statusPage.namestringNo
publicPreview.statusPage.slugstringNo
publicPreview.statusPage.hoststring or nullNo
publicPreview.servicesarray of objectNo
publicPreview.services[].namestringNo
publicPreview.services[].statestringNoOne of: ok, degraded, problem, maintenance.
publicPreview.incidentobject or nullNo
publicPreview.incident.titlestringNo
publicPreview.incident.statusstringNo
publicPreview.incident.messagestring or nullNo
publicPreview.incident.atstring (date-time)No
statusPagesarray of objectNo
statusPages[].idstring (uuid)No
statusPages[].namestringNo
deliveriesarray of object or nullNoWho was told, per channel, oldest first. Empty for incidents from before delivery records existed; null when the record could not be read.
deliveries[].eventstringNoupdate is what a person's manual close, update or reopen sent. One of: opened, reminder, recovered, update, other.
deliveries[].channelIdstring (uuid) or null (uuid)No
deliveries[].channelNamestringNo
deliveries[].channelTypestringNoChannel type such as EMAIL or SLACK, or ALL for an outcome that applied to every channel.
deliveries[].statusstringNoOne of: sent, not_sent, pending.
deliveries[].reasonstring or nullNoPlain-language reason when not sent or still pending.
deliveries[].atstring (date-time)No
updatesarray of objectNo
updates[].idstring (uuid)No
updates[].statusstringNo
updates[].messagestringNo
updates[].authorNamestring or nullNo
updates[].systembooleanNo
updates[].createdAtstring (date-time)No
muteEventsarray of objectNoAlert mutes and unmutes of the monitor while the incident was open, oldest first.
muteEvents[].atstring (date-time)No
muteEvents[].kindstringNoOne of: muted, unmuted.
muteEvents[].byNamestring or nullNo
muteEvents[].untilstring (date-time) or null (date-time)NoEnd of the mute, for muted.
relatedarray of objectNo
related[].idstring (uuid)No
related[].titlestringNo
related[].statestringNoOne of: ongoing, acknowledged, resolved.
related[].startedAtstring (date-time)No
related[].resolvedAtstring (date-time) or null (date-time)No
clusterobject or nullNoPresent only for incidents tied to a server: the monitors on that server it affects and its child incidents. Null otherwise.
cluster.affectedMonitorsarray of objectNo
cluster.clusterRollupobject or nullNo
cluster.separateOpenIssuesarray of objectNo
cluster.childIncidentsarray of objectNo
cluster.childIncidents[].idstring (uuid)No
cluster.childIncidents[].titlestringNo
cluster.childIncidents[].statusstringNo
cluster.childIncidents[].severitystringNo
cluster.childIncidents[].monitorIdstring (uuid) or null (uuid)No
cluster.childIncidents[].monitorobject or nullNo
cluster.childIncidents[].monitor.namestringNo
cluster.childIncidents[].monitor.urlstringNo
cluster.childIncidents[].monitor.statusstringNo
cluster.parentIncidentobject or nullNo
cluster.parentIncident.idstring (uuid)No
cluster.parentIncident.titlestringNo
cluster.parentIncident.statusstringNo
viewerobjectNo
viewer.canEditbooleanNoOwner, Admin or Developer.
viewer.canPostStatusUpdatebooleanNoOwner or Admin.

Used by

Generated from the OpenAPI 3.1 specification at https://docs.visualsentinel.com/openapi.json.