Skip to main content

Container detections

Container detections is the container-security combined detections collection for this CID — ReadCombinedDetections (PEP 8 read_combined_detections) and ReadDetections (PEP 8 read_detections). The paths are GET /container-security/combined/detections/v1 and GET /container-security/entities/detections/v1. Runtime detections, queries detections, and the three count GETs are not implemented. No further roadmap row. Remaining operations stay under Not yet implemented. This is not Container alerts (/container-security/combined/container-alerts/…): Container alerts. This is not the HelloService template sample (GET /api/hello).

This collection is not CrowdStrike production. It does not call Falcon cloud. It is not CrowdStrike Falcon Cloud or Horizon.

RPC field notes: ContainerDetectionsService. REST schemas: API reference. Unused query keys filter and sort are ignored on combined. Extra unused filter, limit, offset, and parameters are ignored on entities (query id is required).

These curls use Host: crowdstrike-api.localhost against Compose Traefik on :8088. If the hostname already resolves to Traefik, you can omit the Host header and call http://crowdstrike-api.localhost instead.

Auth​

Every call needs a console session or a Bearer token:

  • Cookie cs_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with container-detections:read

A session cookie bypasses OAuth scopes and can list and get. Seed client cs-local-hosts (hosts:read only) cannot list or get (403). Unit tests use a client named cs-local-cdet with container-detections:read; that client can list and get. ReadCombinedDetections stays container-detections:read. ReadDetections stays container-detections:read. There is no write scope and no seeded production client with container-detections:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/container-security/combined/detections/v1List container detections. RPC ReadCombinedDetections. PEP 8 read_combined_detections. container-detections:read. Extra unused query filter, sort ignored. Success 200 MSA resources (cid, containers_impacted, description, details, detection_id, detection_name, detection_severity, detection_type, images_impacted, last_detected, remediation, title). Order by detection_id ascending. Distinct from Container alerts. Runtime / queries / three counts are not implemented.
GET/container-security/entities/detections/v1Get one container detection. RPC ReadDetections. PEP 8 read_detections. container-detections:read. Query id (required). Extra unused filter, limit, offset, parameters ignored. Success 200 MSA resource (id, name, detection_type, description, details, image_repository, image_tag, remediation). Missing id → 400. Unknown id → 404. Distinct from Container alerts.

Empty query params on GET combined return every detection in this CID. Default sort is detection_id ascending. Empty store → empty resources, still 200.

JSON is snake_case MSA. Clone success is 200.

GET /container-security/combined/runtime-detections/v2, GET /container-security/queries/detections/v1, GET /container-security/aggregates/detections/count/v1, GET /container-security/aggregates/detections/count-by-severity/v1, and GET /container-security/aggregates/detections/count-by-type/v1 are not implemented. No further roadmap row. Remaining operations stay under Not yet implemented.

Seed detections​

detection_iddetection_namedetection_severitydetection_typecidcontainers_impactedimages_impactednameimage_repositoryimage_tag
det-lab-1Lab detection onehighimagecid-lab21Lab detection onelab/repo1.0
det-lab-2Lab detection twomediumimagecid-lab11Lab detection twolab/repo2.0

List returns det-lab-1 then det-lab-2 in detection_id order. Get id=det-lab-1 returns name Lab detection one.

curl -sS -c cookies.txt -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"FalconLocal!1","cloud":"us-1"}' \
'http://127.0.0.1:8088/identity/entities/sessions/v1'
curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/detections/v1'

Success returns det-lab-1 then det-lab-2.

curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/detections/v1?id=det-lab-1'

Success returns name Lab detection one.

Runtime detections, queries detections, and the three count GETs are not implemented (not yet). Next leftover is p10he Unidentified containers. This is not Container alerts.