Submit detected IOCs to the Collective Insights

Ingest IoC detections from your security tools into Collective Insights to enrich your enterprise's threat intelligence with detection context from firewalls, SIEMs, and other sources.

What this endpoint does

This endpoint ingests indicator of compromise (IoC) detections from your security tools into Collective Insights. You can submit detections for five IoC types—IP addresses, domains, file hashes, vulnerabilities (CVEs), and URLs—each paired with the detection context that triggered the finding, such as a detection rule, correlation, playbook, or sandbox analysis. Optional enrichment fields allow you to include MITRE ATT&CK technique codes, associated malware names, incident references, and source metadata (e.g., firewall, IDS) for each detection. Set the debug option to true to validate submissions without persisting them, which is required for all test data during development. For an overview of the Collective Insights pipeline, consult the Collective Insights: Overview page. To query previously submitted events after they have been enriched, use the Collective Insights: Search endpoint.

Response data

A successful response confirms the processing status and, when the summary option is enabled, returns a breakdown of how many IoCs were processed for each type (IP, domain, hash, vulnerability, URL) along with details about any dropped detections. In non-debug mode, the response also includes object identifiers for the persisted detection records. Detections with unrecognized IoC types are silently dropped rather than causing errors, so review the processed counts to verify all submissions were accepted.

Body Params
data
array of objects
required

A list of detections that has been made and that should be added to Collective Insights.

data*
options
object
organization_ids
array of strings

A list of organizations to associate the submission with. The user making the request must be a member of every organization provided

organization_ids
Responses

500

Server error

502

Server error

503

Server error

504

Server error

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json