Cisco XDR

Cisco XDR Incident API

Incident operations

GitHub OpenAPI
Business capability
Threat Detection & Response Management BC-620.30

Operations 58

POST /ctia/incident/{id}/status Update an Incident Status #
POST /ctia/incident Adds a new Incident #
PUT /ctia/incident/{id} Update an existing Incident #
PATCH /ctia/incident/{id} Partially update an existing Incident #
GET /ctia/incident/{id} Get one Incident by ID #
DELETE /ctia/incident/{id} Delete one Incident #
GET /ctia/incident/external_id/{external_id} List Incident by external id #
GET /ctia/incident/search Search for Incident entities using a ES query syntax and field filters #
DELETE /ctia/incident/search Delete Incident entities matching given Lucene/ES query string or/and field… #
GET /ctia/incident/search/count Count Incident matching a Lucene/ES query string and field filters #
GET /ctia/incident/metric/average Average for some Incident field. #
GET /ctia/incident/metric/histogram Histogram for some Incident field #
GET /ctia/incident/metric/topn Topn for some Incident field #
GET /ctia/incident/metric/cardinality Cardinality for some Incident field #
GET /ctia/{observable_type}/{observable_value}/sightings/incidents Returns Incident references associated with the specified observable based on… #
GET /v1/incident/{incident-id}/assets Incident Assets #
GET /v1/incident/{incident-id}/summary Incident Summary #
GET /v1/incident/{incident-id}/events Incident Events #
POST /v2/incident Create New Incident #
POST /v2/incident/delete Delete Bulk Incidents #
GET /v2/incident/search Search incidents #
GET /v2/incident/search/count Get Count of Incidents by Search #
GET /v2/incident/{incident-id} Get one incident #
PUT /v2/incident/{incident-id} Update one incident #
DELETE /v2/incident/{incident-id} Delete one incident #
PATCH /v2/incident/{incident-id} Patch one incident #
POST /v2/incident/{incident-id}/actions-taken Post actions taken for an incident #
POST /v2/incident/{incident-id}/link/{entity-type}/{entity-id} Link incident and entity (investigation | casebook | incident) #
DELETE /v2/incident/{incident-id}/link/{entity-type}/{entity-id} Unlink incident and entity. (investigation | casebook | incident) #
POST /v2/incident/{incident-id}/update-context Process an incident update by invalidating the cache and finding reputations as… #
GET /v2/incident/{incident-id}/report Incident Report #
GET /v2/incident/{incident-id}/report/{section-id} Incident Report Section #
POST /v2/incident/{incident-id}/report/{section-id} Update Report Section #
POST /v2/incident/{incident-id}/report/{section-id}/regenerate Regenerate a Report Section #
GET /v2/incident/{incident-id}/summary Full Incident Summary. Equivalent Data to v1 summary endpoints #
GET /v2/incident/{incident-id}/mitre Mitre tactics, techniques, and subtechniques found in an incident #
GET /v2/incident/{incident-id}/targets Incident Assets #
GET /v2/incident/{incident-id}/observables Returns a list of observables linked to this incident #
GET /v2/incident/{incident-id}/indicators Returns a list of indicators linked to this incident #
GET /v2/incident/{incident-id}/entities Returns a list of entities associated with this incident #
GET /v2/incident/{incident-id}/events Returns a list of events linked to this incident #
POST /v2/incident/{incident-id}/events Returns a list of events linked to this incident #
GET /v2/incident/{incident-id}/status Returns the underlying incident's investigation status with surrounding threat… #
POST /v2/incident/{incident-id}/status Update an incident status #
GET /v2/incident/{incident-id}/event-filters Returns the available filter params for this incident's events #
GET /v2/incident/{incident-id}/verdicts Returns a list of events linked to this incident #
GET /v2/incident/{incident-id}/graph Returns a graph representation of this incident #
GET /v2/incident/{incident-id}/linked-casebooks Return Linked Casebooks #
GET /v2/incident/{incident-id}/linked-incidents Returns linked incidents #
GET /v2/incident/{incident-id}/primary-investigation Returns linked investigations #
GET /v2/incident/{incident-id}/errors Returns a list of errors reported by the attached investigations #
GET /v2/incident/{incident-id}/overview Returns baseline incident information #
GET /v2/incident/{incident-id}/recommend Recommend actions for an incident #
GET /v2/incident/{incident-id}/export Get a full summary of the incident, everything seen in XDR #
POST /v2/incident/{incident-id}/import Import Incident and all its surrounding threat context from CTIA #
GET /v3/incident/filters incident search filter values #
POST /v3/incident/search Search incidents #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cisco-xdr/refs/heads/main/openapi/cisco-xdr-incident-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cisco-xdr:cisco-xdr-incident-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cisco-xdr-incident-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Cisco Xdr Incident API
  x-refined-note:
  - x-evidence differs across the merged source definitions and was not carried
  - x-provenance differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Incident across 2 of this provider''s published API definitions: cisco-xdr-ctia-openapi.json, cisco-xdr-incidents-investigations-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /
tags:


# --- truncated at 32 KB (7083 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-xdr/refs/heads/main/openapi/cisco-xdr-incident-api-openapi.yml