> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident.md).
# incident
### Examples
```graphql
type Incident {
id: String!
caseId: String!
name: String!
description: String
type: IncidentType!
severity: IncidentSeverity!
status: IncidentStatus!
classification: IncidentClassification
scope: IncidentScope
exploitationStatus: CveExploitationStatus
blockedReason: String
owner: String
creator: String!
slaTargetAt: DateTime
settings: IncidentSettings!
isOxDeclared: Boolean!
publishType: IncidentPublishType!
publishTypeReason: String
autoExpandFromSource: Boolean!
externalReferences: [String!]!
sourcePublishedAt: DateTime
sourceCreatedAt: DateTime
kevDiscoveredAt: DateTime
oxPublishedAt: DateTime
counts: IncidentCounts!
exposureState: ExposureState
currentSeverity: IncidentSeverity
isMonitoring: Boolean!
affectedResourceCount: Int!
summary: [IncidentSummarySection!]!
aiSummary: IncidentAiSummary
indicatorCounts: IncidentIndicatorCounts
lastRunDelta: IncidentLastRunDelta
countsAsOf: DateTime
lastMatchedAt: DateTime
lastExposureChange: DateTime
resolvedAt: DateTime
createdAt: DateTime
updatedAt: DateTime
indicators: [Indicator!]
}
```
### Fields
| Field | Description | Supported fields |
| --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id `String!` | | |
| caseId `String!` | | |
| name `String!` | | |
| description `String` | | |
| type [`IncidentType!`](/api-documentation/api-reference/api--response-center/types/enums/incident-type.md) | | |
| severity [`IncidentSeverity!`](/api-documentation/api-reference/api--response-center/types/enums/incident-severity.md) | | |
| status [`IncidentStatus!`](/api-documentation/api-reference/api--response-center/types/enums/incident-status.md) | | |
| classification [`IncidentClassification`](/api-documentation/api-reference/api--response-center/types/objects/incident-classification.md) | Structured threat classification extracted from the incident sources. Absent until a source establishes one. | attackType IncidentAttackType
campaignName String
primaryImpact IncidentImpact
secondaryImpacts \[IncidentImpact!]
impactTargets \[IncidentImpactTarget!]
capabilities \[IncidentCapability!]
executionTriggers \[IncidentExecutionTrigger!]
evidence IncidentClassificationEvidence
metadataContractVersion String
|
| scope [`IncidentScope`](/api-documentation/api-reference/api--response-center/types/enums/incident-scope.md) | Derived breadth of the monitored threat. Populated on the detail query. | |
| exploitationStatus [`CveExploitationStatus`](/api-documentation/api-reference/api--response-center/types/enums/cve-exploitation-status.md) | The strongest stored exploitation posture across the monitored CVEs. Absent on the list query and for incidents that monitor no CVEs. | |
| blockedReason `String` | | |
| owner `String` | | |
| creator `String!` | | |
| slaTargetAt `DateTime` | | |
| settings [`IncidentSettings!`](/api-documentation/api-reference/api--response-center/types/objects/incident-settings.md) | | allowManualClosure Boolean!
autoCloseWhenResolved Boolean!
cleanDaysBeforeClose Int!
autoReopenOnNewHit Boolean!
watchWindowDays Int!
|
| isOxDeclared `Boolean!` | | |
| publishType [`IncidentPublishType!`](/api-documentation/api-reference/api--response-center/types/enums/incident-publish-type.md) | The immutable product flow that originally published this incident. | |
| publishTypeReason `String` | The immutable flow-specific publication reason. Legacy incidents may not have one. | |
| autoExpandFromSource `Boolean!` | | |
| externalReferences `[String!]!` | | |
| ~~sourcePublishedAt `DateTime`~~ ⚠️ | **Deprecated**: Use sourceCreatedAt. | |
| sourceCreatedAt `DateTime` | Publication timestamp of the original GHSA, NVD advisory, or source article. | |
| kevDiscoveredAt `DateTime` | Earliest accepted discovery date across CISA KEV, VulnCheck KEV, and EU KEV. | |
| oxPublishedAt `DateTime` | Publication timestamp of the global OX Feed template that created this incident. | |
| counts [`IncidentCounts!`](/api-documentation/api-reference/api--response-center/types/objects/incident-counts.md) | | affectedApps Int!
affectedRepos Int!
affectedImages Int!
openFindings Int!
resolvedFindings Int!
removedFindings Int!
sbomMatches Int!
removedSbomMatches Int!
pipelineHits Int!
devEnvironments Int!
clearedMatches Int!
blockedItems Int!
cloudAccounts Int!
cloudRunningImages Int!
cloudRunningThisVersionImages Int!
openFindingsBySeverity IncidentSeverityCounts!
|
| exposureState [`ExposureState`](/api-documentation/api-reference/api--response-center/types/enums/exposure-state.md) | | |
| currentSeverity [`IncidentSeverity`](/api-documentation/api-reference/api--response-center/types/enums/incident-severity.md) | | |
| isMonitoring `Boolean!` | | |
| affectedResourceCount `Int!` | | |
| summary [`[IncidentSummarySection!]!`](/api-documentation/api-reference/api--response-center/types/objects/incident-summary-section.md) | | title String!
bullets \[String!]!
lines \[IncidentSummaryLine!]!
|
| aiSummary [`IncidentAiSummary`](/api-documentation/api-reference/api--response-center/types/objects/incident-ai-summary.md) | | bullets \[String!]!
generatedAt DateTime
model String
|
| indicatorCounts [`IncidentIndicatorCounts`](/api-documentation/api-reference/api--response-center/types/objects/incident-indicator-counts.md) | | cve Int!
package Int!
packageRange Int!
image Int!
issue Int!
advisorySource Int!
|
| lastRunDelta [`IncidentLastRunDelta`](/api-documentation/api-reference/api--response-center/types/objects/incident-last-run-delta.md) | | newCount Int!
resolvedCount Int!
removedCount Int!
issues IncidentRunDelta
sboms IncidentRunDelta
|
| countsAsOf `DateTime` | | |
| lastMatchedAt `DateTime` | | |
| lastExposureChange `DateTime` | | |
| resolvedAt `DateTime` | | |
| createdAt `DateTime` | | |
| updatedAt `DateTime` | | |
| indicators [`[Indicator!]`](/api-documentation/api-reference/api--response-center/types/objects/indicator.md) | | id String!
incidentId String!
kind IndicatorKind!
value String!
versionRange String
fixedVersions \[String!]!
remediationStatus IndicatorRemediationStatus
remediations \[IndicatorRemediation!]!
isCompromised Boolean
isCompromisedBasis String
infectsOnInstall Boolean
ecosystem String
severity IncidentSeverity
cvssScore Float
cveIntelligence CveIntelligence
cweMetadata CweMetadata
addedAt DateTime!
source String!
addedBy String
status String!
url String
lastFetchedAt DateTime
autoExpand Boolean
matchState IndicatorMatchState
activeMatchCount Int
isUnpinned Boolean
|
### References
#### Queries using this object:
* [\ getIncident](/api-documentation/api-reference/api--response-center/queries/get-incident.md)
#### Mutations using this object:
* [<\~> updateIncidentName](/api-documentation/api-reference/api--response-center/mutations/update-incident-name.md)
* [<\~> updateIncidentDescription](/api-documentation/api-reference/api--response-center/mutations/update-incident-description.md)
* [<\~> updateIncidentSeverity](/api-documentation/api-reference/api--response-center/mutations/update-incident-severity.md)
* [<\~> updateIncidentType](/api-documentation/api-reference/api--response-center/mutations/update-incident-type.md)
* [<\~> updateIncidentStatus](/api-documentation/api-reference/api--response-center/mutations/update-incident-status.md)
* [<\~> createIncident](/api-documentation/api-reference/api--response-center/mutations/create-incident.md)
#### Fields with this object:
* [{} IncidentsConnection.items](/api-documentation/api-reference/api--response-center/types/objects/incidents-connection.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.