> 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/extracted-incident-draft.md).

# extractedIncidentDraft

### Examples

```graphql
type ExtractedIncidentDraft {
  requiredCves: [String!]
  missingRequiredCves: [String!]
  extractionToken: String
  name: String
  description: String
  type: IncidentType
  severity: IncidentSeverity
  publishedDate: String
  classification: IncidentClassification
  indicators: [ExtractedIndicator!]!
  confidence: String!
  sourceUrls: [String!]!
  sources: [ExtractionSourceResolution!]!
  unfilledFields: [String!]!
  warnings: [String!]!
  indicatorScopeTruncated: Boolean
  automaticPreviewComplete: Boolean
  extractedScopeUnavailable: Boolean
}
```

### Fields

| Field                                                                                                                                                                   | Description                                                                                                   | Supported fields                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| requiredCves `[String!]`                                                                                                                                                | Required candidate CVEs covered by this extraction request.                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| missingRequiredCves `[String!]`                                                                                                                                         | Required candidate CVEs that could not be resolved.                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| extractionToken `String`                                                                                                                                                |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| name `String`                                                                                                                                                           |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| description `String`                                                                                                                                                    |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| type [`IncidentType`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-type.md)                                       |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| severity [`IncidentSeverity`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-severity.md)                           |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| publishedDate `String`                                                                                                                                                  |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| classification [`IncidentClassification`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident-classification.md)       | Structured threat classification derived from the sources. Absent when no source establishes one.             | <p>attackType <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-attack-type.md"><code>IncidentAttackType</code></a><br>campaignName <code>String</code><br>primaryImpact <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-impact.md"><code>IncidentImpact</code></a><br>secondaryImpacts <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-impact.md"><code>\[IncidentImpact!]</code></a><br>impactTargets <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-impact-target.md"><code>\[IncidentImpactTarget!]</code></a><br>capabilities <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-capability.md"><code>\[IncidentCapability!]</code></a><br>executionTriggers <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-execution-trigger.md"><code>\[IncidentExecutionTrigger!]</code></a><br>evidence <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident-classification-evidence.md"><code>IncidentClassificationEvidence</code></a><br>metadataContractVersion <code>String</code></p>                                                                                                                                                                                                                                                                                                                                                               |
| indicators [`[ExtractedIndicator!]!`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/extracted-indicator.md)               |                                                                                                               | <p>cveIds <code>\[String!]</code><br>hasIndependentSupport <code>Boolean</code><br>osvAffectedVersions <code>\[String!]</code><br>osvAffectedRanges <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/osv-affected-range.md"><code>\[OsvAffectedRange!]</code></a><br>kind <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/indicator-kind.md"><code>IndicatorKind!</code></a><br>value <code>String!</code><br>versionRange <code>String</code><br>fixedVersions <code>\[String!]!</code><br>remediationStatus <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/indicator-remediation-status.md"><code>IndicatorRemediationStatus!</code></a><br>remediations <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/extracted-remediation.md"><code>\[ExtractedRemediation!]!</code></a><br>isCompromised <code>Boolean</code><br>isCompromisedBasis <code>String</code><br>infectsOnInstall <code>Boolean</code><br>ecosystem <code>String</code><br>severity <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-severity.md"><code>IncidentSeverity</code></a><br>cvssScore <code>Float</code><br>cvssVersion <code>String</code><br>cveIntelligence <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/cve-intelligence.md"><code>CveIntelligence</code></a><br>aiExploitSimulation <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/ai-exploit-simulation.md"><code>AiExploitSimulation</code></a></p> |
| confidence `String!`                                                                                                                                                    |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| sourceUrls `[String!]!`                                                                                                                                                 |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| sources [`[ExtractionSourceResolution!]!`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/extraction-source-resolution.md) |                                                                                                               | <p>url <code>String!</code><br>via <code>String!</code><br>ok <code>Boolean!</code><br>indicatorCount <code>Float</code><br>resolvedUrl <code>String</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| unfilledFields `[String!]!`                                                                                                                                             |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| warnings `[String!]!`                                                                                                                                                   |                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| indicatorScopeTruncated `Boolean`                                                                                                                                       | Whether extraction discarded indicators because the monitored scope exceeded its limit.                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| automaticPreviewComplete `Boolean`                                                                                                                                      | Whether all sources and required enrichment completed for automatic publication.                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| extractedScopeUnavailable `Boolean`                                                                                                                                     | Some extracted indicator scope could not be represented safely; warnings explain the unresolved restrictions. |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

### References

#### Mutations using this object:

* [<\~> extractIncidentFromUrls](https://docs.ox.security/api-documentation/api-reference/api--response-center/mutations/extract-incident-from-urls.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/extracted-incident-draft.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
