How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Cisco XDR

Cisco XDR V2 API

The v2 API from Cisco XDR — 75 operation(s) for v2.

Documentation Provider Profile APIs.io OpenAPI GitHub

Cisco XDR V2 API is one of 83 APIs that Cisco XDR publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include v2. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 85 operations across 75 paths. It is described by OpenAPI 3.2.0, at version conure-218-1-ee422dee.

Requests are made against the base URL https://private.intel.amp.cisco.com.

85 operations 75 paths 0 schemas 4 DELETE53 GET2 PATCH23 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
conure-218-1-ee422dee
Base URL
https://private.intel.amp.cisco.com
Authentication
API Key, OAuth 2.0
Contact
Cisco Security Business Group -- Advanced Threat
License
All Rights Reserved
Resource Areas
1

Authentication & Security 2

Cisco XDR V2 API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (JWT-Bearer). It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 13 scopes.

Paths & Operations 85

Across 75 paths, the API surfaces 85 operations — 4 DELETE, 53 GET, 2 PATCH, 23 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

v2 85
POST
/v2/casebook
Adds a new Casebook
body → 405default429401500201404400
GET
/v2/casebook/external_id/{external-id}
List Casebook by external id
7 params → 405default429401500200404400
GET
/v2/casebook/search
Search casebooks
17 params → 405default429401500200404400
GET
/v2/casebook/{casebook-id}
Get one casebook by id
1 param → 405default429401500200404400
PUT
/v2/casebook/{casebook-id}
Updates a Casebook
1 param body → 405default429401500200404400
DELETE
/v2/casebook/{casebook-id}
Deletes a Casebook
1 param → 204405default429401500404400
PATCH
/v2/casebook/{casebook-id}
Partially Update a Casebook
1 param body → 405default429401500200404400
GET
/v2/casebook/{casebook-id}/summary
Returns a casebook and it's related incidents.
1 param → 405default429401500200404400
POST
/v2/casebook/{casebook-id}/observables
Updates a casebook's observables
1 param body → 405default429401500200404400
POST
/v2/casebook/{casebook-id}/bundle
Updates a casebook's bundle
1 param body → 405default429401500200404400
POST
/v2/casebook/{casebook-id}/texts
Updates a casebook's texts
1 param body → 405default429401500200404400
POST
/v2/investigation
Create Investigation
body → 405default429401500200404400
POST
/v2/investigation/bundle
Create Investigation from Snapshot
body → 405default429401500200404400
POST
/v2/investigation/snapshot
Create Investigation from Snapshot
body → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/snapshot
Create Investigation from Investigation Id
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/errors
Investigation Errors
1 param → default
GET
/v2/investigation/{investigation-id}/entities
Investigation Entities
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/events
Investigation Events
11 params → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/verdicts
Investigation Verdicts
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/graph
Investigation Relation Graph
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/indicators
Returns a list of indicators attached to this investigation
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/observables
Returns a list of observables attached to this investigation
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/overview
Returns metadata about the investigation
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/status
Investigation Status
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/summary
Returns a Summary of the Investigation
1 param → 405default429401500200404400
GET
/v2/investigation/{investigation-id}/targets
Returns a list of targets attached to this investigation
1 param → 405default429401500200404400
POST
/v2/investigation/{investigation-id}/bundle
Add Threat context to an investigation
1 param body → 405default429401500200404400
POST
/v2/investigation/{investigation-id}/observable/add
Add observables to an investigation
1 param body → 405default429401500200404400
POST
/v2/investigation/{investigation-id}/observable/remove
Remove observables from an investigation.
1 param body → 405default429401500200404400
POST
/v2/investigation/{investigation-id}/task
Run a task
1 param body → 405default429401500200404400
PUT
/v2/investigation/{investigation-id}/edit
Saves an investigation in place.
1 param body → 405default429401500200404400
POST
/v2/investigation/{investigation-id}/copy
Create a copy of an investigation.
1 param body → 405default429401500200404400
DELETE
/v2/investigation/{investigation-id}/delete
1 param → 405default429401500200404400
POST
/v2/investigation/{investigation-id}/save-as
Saves an investigation as a new entity.
1 param body → 405default429401500200404400
POST
/v2/incident
Create New Incident
body → 405default429401500201404400
POST
/v2/incident/delete
Delete Bulk Incidents
body → 405default429401500200404400
GET
/v2/incident/search
Search incidents
25 params → 405default429401500200404400
GET
/v2/incident/search/count
Get Count of Incidents by Search
25 params → 405default429401500200404400
GET
/v2/incident/{incident-id}
Get one incident.
1 param → 405default429401500200404400
PUT
/v2/incident/{incident-id}
Update one incident.
1 param body → 405default429401500200404400
DELETE
/v2/incident/{incident-id}
Delete one incident.
1 param → 204405default429401500404400
PATCH
/v2/incident/{incident-id}
Patch one incident.
1 param body → 405default429401500200404400
POST
/v2/incident/{incident-id}/actions-taken
Post actions taken for an incident
1 param body → 405default429401500201404400
POST
/v2/incident/{incident-id}/link/{entity-type}/{entity-id}
Link incident and entity (investigation | casebook | incident)
3 params → 405default429401500201404400
DELETE
/v2/incident/{incident-id}/link/{entity-type}/{entity-id}
Unlink incident and entity. (investigation | casebook | incident)
3 params → 204405default429401500404400
POST
/v2/incident/{incident-id}/update-context
Process an incident update by invalidating the cache and finding reputations as well as resolving assets.
1 param body → 204405default429401500404400
GET
/v2/incident/{incident-id}/report
Incident Report
2 params → 405default429401500200404400
GET
/v2/incident/{incident-id}/report/{section-id}
Incident Report Section
3 params → 405default429401500200404400
POST
/v2/incident/{incident-id}/report/{section-id}
Update Report Section
3 params body → 405default429401500200404400
POST
/v2/incident/{incident-id}/report/{section-id}/regenerate
Regenerate a Report Section
3 params → 405default429401500200404400
GET
/v2/incident/{incident-id}/summary
Full Incident Summary. Equivalent Data to v1 summary endpoints.
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/mitre
Mitre tactics, techniques, and subtechniques found in an incident
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/targets
Incident Assets
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/observables
Returns a list of observables linked to this incident.
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/indicators
Returns a list of indicators linked to this incident.
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/entities
Returns a list of entities associated with this incident.
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/events
Returns a list of events linked to this incident.
11 params → 405default429401500200404400
POST
/v2/incident/{incident-id}/events
Returns a list of events linked to this incident.
11 params body → 405default429401500200404400
GET
/v2/incident/{incident-id}/status
Returns the underlying incident's investigation status with surrounding threat context.
1 param → 405default429401500200404400
POST
/v2/incident/{incident-id}/status
Update an incident status.
1 param body → 405default429401500200404400
GET
/v2/incident/{incident-id}/event-filters
Returns the available filter params for this incident's events
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/verdicts
Returns a list of events linked to this incident.
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/graph
Returns a graph representation of this incident.
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/linked-casebooks
Return Linked Casebooks
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/linked-incidents
Returns linked incidents
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/primary-investigation
Returns linked investigations
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/errors
Returns a list of errors reported by the attached investigations
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/overview
Returns baseline incident information
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/recommend
Recommend actions for an incident.
1 param → 405default429401500200404400
GET
/v2/incident/{incident-id}/export
Get a full summary of the incident, everything seen in XDR
2 params → 405default429401500200404400
POST
/v2/incident/{incident-id}/import
Import Incident and all its surrounding threat context from CTIA
1 param → 405default429401500201404400
GET
/v2/sighting/{sighting-id}/findings
Get the findings for a sighting ID
1 param → 405default429401500200404400
GET
/v2/report/incident-status-by-assignment
Incident counts by status and assignment bucket
1 param → 405default429401500200404400
GET
/v2/report/mitre-attack-incidents
Non-closed incident counts by MITRE tactic and technique
1 param → 405default429401500200404400
GET
/v2/report/top-seen-techniques
Top seen techniques across incidents
1 param → 405default429401500200404400
GET
/v2/report/detection-sources-histogram
Daily incident counts per detection source
1 param → 405default429401500200404400
GET
/v2/report/top-targeted-devices
Top targeted devices across incidents
1 param → 405default429401500200404400
GET
/v2/report/top-targeted-users
Top targeted users across incidents
1 param → 405default429401500200404400
GET
/v2/report/top-targeted-assets
Top targeted assets across incidents
1 param → 405default429401500200404400
GET
/v2/report/team-mean-time-to-engage
Team mean time to engage over the period
1 param → 405default429401500200404400
GET
/v2/report/user-mean-time-to-engage
Requesting user's mean time to engage over the period
1 param → 405default429401500200404400
GET
/v2/report/team-mean-time-to-contain
Team mean time to contain over the period
1 param → 405default429401500200404400
GET
/v2/report/user-mean-time-to-contain
User mean time to contain over the period
1 param → 405default429401500200404400
GET
/v2/report/team-mean-time-to-resolve
Team mean time to resolve over the period
1 param → 405default429401500200404400
GET
/v2/report/user-mean-time-to-resolve
Requesting user's mean time to resolve over the period
1 param → 405default429401500200404400

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cisco-xdr-v2-api-openapi.yml Raw ↑

Other APIs Cisco XDR publishes across the network.

Cisco XDR Actor API
AE Profile APIs.io
Cisco XDR Asset API
AE Profile APIs.io
Cisco XDR Asset Mapping API
AE Profile APIs.io
Cisco XDR Asset Properties API
AE Profile APIs.io
Cisco XDR Attack Pattern API
AE Profile APIs.io
Cisco XDR Bulk API
AE Profile APIs.io
Cisco XDR Bundle API
AE Profile APIs.io
Cisco XDR Campaign API
AE Profile APIs.io
Cisco XDR Casebook API
AE Profile APIs.io
Cisco XDR COA API
AE Profile APIs.io
Cisco XDR Deliberate API
AE Profile APIs.io
Cisco XDR Event API
AE Profile APIs.io
#v2
← Back to C APIs
API Details
ID
cisco-xdr:cisco-xdr-v2-api
Base URL
https://private.intel.amp.cisco.com
Docs
https://developer.cisco.com/docs/cisco-xdr/
Provider
Cisco XDR
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=cisco-xdr-v2-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/cisco-xdr-v2-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Cisco XDR V2 API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.