> 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-evidence-item.md).

# incidentEvidenceItem

### Examples

```graphql
type IncidentEvidenceItem {
  vexStatuses: [ScannerVexStatus!]
  vexAssessments: [IncidentScannerVexAssessment!]
  vexAssessmentOverflow: Int
  applicableCves: [String!]
  id: String!
  incidentId: String!
  category: EvidenceCategory!
  state: EvidenceState!
  severity: IncidentSeverity
  title: String!
  resourceName: String!
  resourceDetail: String
  pipelineOutcome: PipelineOutcome
  targetBranch: String
  appName: String
  appType: String
  hitIndicatorValues: [String!]!
  foundVersion: String
  libraryName: String
  libraryVersion: String
  isRunning: Boolean
  runtimeStatus: String
  cloudRunState: CloudRunState
  isUsed: Boolean
  aiSimulation: AiSimulationVerdict
  exploitabilityVerdict: ExploitabilityVerdict
  cveExploitability: [CveExploitability!]
  cveExploitabilityOverflow: Int
  linkedIssueId: String
  factorEvidence: [IncidentEvidenceFactorEvidence!]
  isInternetExposed: Boolean
  dependencyType: EvidenceDependencyType
  pinState: String
  stateReason: String
  externalUrl: String
  asOf: DateTime!
  developerEmail: String
  commandRanAt: DateTime
  devEnvironmentOutcome: DevEnvironmentOutcome
  resourceOwner: String
  issueId: String
  joinableIssueId: String
  jiraTicketKeys: [String!]
  sbomAppId: String
  sbomLibrary: String
  isFixAvailable: Boolean
  hasTicket: Boolean
  commentCount: Int
  latestCommentText: String
  latestCommentAuthorName: String
  latestCommentAt: DateTime
  isGptAvailable: Boolean
  isExcluded: Boolean
  hasJiraTicket: Boolean
  hasNonJiraTicket: Boolean
  hasSeverityOverride: Boolean
  originalIssueSeverity: IncidentSeverity
  hasOwnerOverride: Boolean
  originalOwnerName: String
  originalOwnerEmail: String
  currentOwnerName: String
  currentOwnerEmail: String
  hasMessages: Boolean
  isFixApplied: Boolean
  isExcludedByAlert: Boolean
  isFalsePositive: Boolean
  isCanceledFalsePositive: Boolean
  appTags: [String!]!
  businessUnits: [IncidentBusinessUnitRef!]!
  hasPullRequest: Boolean
  eventAt: DateTime
  exposureBlocked: Boolean
  exposureSuppressedBy: String
  exposureCounted: Boolean!
  exposureNotCountedReason: EvidenceExposureNotCountedReason
  hasFalsePositiveDetails: Boolean
  falsePositiveComment: String
  cancelFalsePositiveComment: String
}
```

### Fields

| Field                                                                                                                                                                                            | Description                                                                                                                                                                                                                                   | Supported fields                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| vexStatuses [`[ScannerVexStatus!]`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/scanner-vex-status.md)                                             | Distinct scanner VEX statuses across all matched assessments, including those beyond the detail limit.                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| vexAssessments [`[IncidentScannerVexAssessment!]`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident-scanner-vex-assessment.md)               | Scanner VEX assessments for the matched CVE and package contexts, capped at fifty entries.                                                                                                                                                    | <p>oxSeverity <code>Float</code><br>dependencyType <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/scanner-vex-dependency-type.md"><code>ScannerVexDependencyType</code></a><br>chainDepth <code>Int</code><br>dependencyChain <code>String</code><br>cve <code>String</code><br>libraryName <code>String</code><br>libraryVersion <code>String</code><br>status <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/scanner-vex-status.md"><code>ScannerVexStatus!</code></a><br>reason <code>String</code><br>severityFactorId <code>String</code></p> |
| vexAssessmentOverflow `Int`                                                                                                                                                                      | The number of matched scanner assessments omitted from the bounded detail list.                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| applicableCves `[String!]`                                                                                                                                                                       | CVEs whose linked advisory package scopes match this version. These are advisory applicability results, independent of scanner-confirmed CVE findings.                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| id `String!`                                                                                                                                                                                     |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| incidentId `String!`                                                                                                                                                                             |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| category [`EvidenceCategory!`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/evidence-category.md)                                                   |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| state [`EvidenceState!`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/evidence-state.md)                                                            |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| severity [`IncidentSeverity`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-severity.md)                                                    |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| title `String!`                                                                                                                                                                                  |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| resourceName `String!`                                                                                                                                                                           |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| resourceDetail `String`                                                                                                                                                                          |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| pipelineOutcome [`PipelineOutcome`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/pipeline-outcome.md)                                               |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| targetBranch `String`                                                                                                                                                                            |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| appName `String`                                                                                                                                                                                 |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| appType `String`                                                                                                                                                                                 |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hitIndicatorValues `[String!]!`                                                                                                                                                                  |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| foundVersion `String`                                                                                                                                                                            | The version of the matched package found in this row. Absent for issue rows and when the match did not evaluate a version.                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| libraryName `String`                                                                                                                                                                             | The name of the package this row represents. Absent when no package identity is available for the row.                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| libraryVersion `String`                                                                                                                                                                          | The version of the package this row represents. Absent when no package identity is available for the row.                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isRunning `Boolean`                                                                                                                                                                              |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| runtimeStatus `String`                                                                                                                                                                           |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| cloudRunState [`CloudRunState`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/cloud-run-state.md)                                                    |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isUsed `Boolean`                                                                                                                                                                                 | The scanner usage or import verdict for Code SBOM, Code Issue and Container Issue rows. Issue rows expose the specific signal through factorEvidence. Absent when usage is not evaluated.                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| aiSimulation [`AiSimulationVerdict`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/ai-simulation-verdict.md)                                         | Code Issue and Container Issue rows only. Whether the AI simulator judged the matched CVE exploit path reachable. Absent when no matched CVE carries an AI Simulation verdict.                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ~~exploitabilityVerdict~~ [~~`ExploitabilityVerdict`~~](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/exploitability-verdict.md) ⚠️                  | **Deprecated**: Use scanner VEX assessments instead. This field no longer returns a calculated verdict.                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ~~cveExploitability~~ [~~`[CveExploitability!]`~~](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/cve-exploitability.md) ⚠️                         | **Deprecated**: Use scanner VEX assessments instead. This field no longer returns a calculated verdict.                                                                                                                                       | <p>cve <code>String!</code><br>library <code>String</code><br>verdict <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/exploitability-verdict.md"><code>ExploitabilityVerdict!</code></a><br>aiSimulation <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/ai-simulation-verdict.md"><code>AiSimulationVerdict</code></a><br>runtimeStatus <code>String</code></p>                                                                                                                                                                                     |
| ~~cveExploitabilityOverflow `Int`~~ ⚠️                                                                                                                                                           | **Deprecated**: Use scanner VEX assessments instead. This field no longer returns a calculated verdict.                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| linkedIssueId `String`                                                                                                                                                                           | Code Issue and Container Issue rows only. The scanner issue id of the linked issue: the code issue of a container issue, or the container issue of a code issue. Absent when the scanner links no issue.                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| factorEvidence [`[IncidentEvidenceFactorEvidence!]`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident-evidence-factor-evidence.md)           | Severity-factor evidence backing the Findings verdict columns, scoped to the CVEs and library this row matched. Only populated when includeFactorEvidence is requested; absent for non-issue rows or when no matched factor carries evidence. | <p>signal <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/factor-evidence-signal.md"><code>FactorEvidenceSignal!</code></a><br>factorId <code>String!</code><br>factorName <code>String!</code><br>cve <code>String</code><br>library <code>String</code><br>items <a href="https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident-evidence-factor-evidence-item.md"><code>\[IncidentEvidenceFactorEvidenceItem!]!</code></a></p>                                                                                                                         |
| isInternetExposed `Boolean`                                                                                                                                                                      |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| dependencyType [`EvidenceDependencyType`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/evidence-dependency-type.md)                                 |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| pinState `String`                                                                                                                                                                                |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| stateReason `String`                                                                                                                                                                             |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| externalUrl `String`                                                                                                                                                                             |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| asOf `DateTime!`                                                                                                                                                                                 |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| developerEmail `String`                                                                                                                                                                          |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| commandRanAt `DateTime`                                                                                                                                                                          | DevEnvironment rows — when the install command actually ran.                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| devEnvironmentOutcome [`DevEnvironmentOutcome`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/dev-environment-outcome.md)                            | DevEnvironment rows — the ox-ai-agent governance verdict for the install: Blocked, Flagged, or Allowed.                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| resourceOwner `String`                                                                                                                                                                           |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| issueId `String`                                                                                                                                                                                 |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| joinableIssueId `String`                                                                                                                                                                         | The scanner issue id that is safe to join on for issue mutations. Absent when the row carries no real issue id.                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| jiraTicketKeys `[String!]`                                                                                                                                                                       | Keys of the Jira tickets already attached to the source issue.                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| sbomAppId `String`                                                                                                                                                                               |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| sbomLibrary `String`                                                                                                                                                                             |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isFixAvailable `Boolean`                                                                                                                                                                         |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hasTicket `Boolean`                                                                                                                                                                              |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| commentCount `Int`                                                                                                                                                                               |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| latestCommentText `String`                                                                                                                                                                       | Newest comment body, truncated — drives the Actions-column comment tooltip preview.                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| latestCommentAuthorName `String`                                                                                                                                                                 |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| latestCommentAt `DateTime`                                                                                                                                                                       |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isGptAvailable `Boolean`                                                                                                                                                                         |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isExcluded `Boolean`                                                                                                                                                                             |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hasJiraTicket `Boolean`                                                                                                                                                                          |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hasNonJiraTicket `Boolean`                                                                                                                                                                       |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hasSeverityOverride `Boolean`                                                                                                                                                                    |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| originalIssueSeverity [`IncidentSeverity`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/incident-severity.md)                                       |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hasOwnerOverride `Boolean`                                                                                                                                                                       |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| originalOwnerName `String`                                                                                                                                                                       |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| originalOwnerEmail `String`                                                                                                                                                                      |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| currentOwnerName `String`                                                                                                                                                                        |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| currentOwnerEmail `String`                                                                                                                                                                       |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hasMessages `Boolean`                                                                                                                                                                            |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isFixApplied `Boolean`                                                                                                                                                                           |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isExcludedByAlert `Boolean`                                                                                                                                                                      |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isFalsePositive `Boolean`                                                                                                                                                                        |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| isCanceledFalsePositive `Boolean`                                                                                                                                                                |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| appTags `[String!]!`                                                                                                                                                                             | Application tags of the application this evidence row belongs to, resolved per request from the current tag assignments of that application. Empty when the application carries no tags or could not be resolved.                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| businessUnits [`[IncidentBusinessUnitRef!]!`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident-business-unit-ref.md)                         | Business units of the application this evidence row belongs to, resolved per request from the org-unit hierarchy. Empty when the application belongs to no business unit or could not be resolved.                                            | <p>id <code>String!</code><br>name <code>String!</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| hasPullRequest `Boolean`                                                                                                                                                                         | Whether an OX-opened pull request is attached to the source issue of this evidence row.                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| eventAt `DateTime`                                                                                                                                                                               | When the underlying event happened: the pipeline job trigger time or the developer-environment command time. Absent on rows matched before event times were recorded.                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| exposureBlocked `Boolean`                                                                                                                                                                        | Whether the pipeline gate or developer-environment tool blocked this event; blocked rows never count as exposure.                                                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| exposureSuppressedBy `String`                                                                                                                                                                    | Why an SBOM evidence row is shown but does not count as exposure: cleared-issue when its corresponding issue was cleared, excluded-issue when its corresponding issue was excluded. Absent when the row counts normally.                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| exposureCounted `Boolean!`                                                                                                                                                                       | Whether the row currently counts toward the incident exposure counts. Computed when the row is read, using the same rules as the stored counts.                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| exposureNotCountedReason [`EvidenceExposureNotCountedReason`](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/enums/evidence-exposure-not-counted-reason.md) | The reason the row does not count toward the incident exposure counts. Absent when the row counts.                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| hasFalsePositiveDetails `Boolean`                                                                                                                                                                |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| falsePositiveComment `String`                                                                                                                                                                    |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| cancelFalsePositiveComment `String`                                                                                                                                                              |                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

### References

#### Fields with this object:

* [{} IncidentEvidenceGroup.items](https://docs.ox.security/api-documentation/api-reference/api--response-center/types/objects/incident-evidence-group.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/incident-evidence-item.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.
