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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithcontainer-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
| Method | Path | Use |
|---|---|---|
GET | /container-security/combined/detections/v1 | List 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/v1 | Get 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_id | detection_name | detection_severity | detection_type | cid | containers_impacted | images_impacted | name | image_repository | image_tag |
|---|---|---|---|---|---|---|---|---|---|
det-lab-1 | Lab detection one | high | image | cid-lab | 2 | 1 | Lab detection one | lab/repo | 1.0 |
det-lab-2 | Lab detection two | medium | image | cid-lab | 1 | 1 | Lab detection two | lab/repo | 2.0 |
List returns det-lab-1 then det-lab-2 in detection_id
order. Get id=det-lab-1 returns name Lab detection one.
Session cookie
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'
ReadCombinedDetections (cookie)
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.
ReadDetections (cookie)
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.
Related
- Container alerts — container alert list
- API reference
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.