Skip to main content

Alerts

Alerts is the Falcon Alerts collection for this CID. Paths are under /alerts/…. Aggregates, tags, assign, and comments are not implemented.

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

RPC field notes: AlertsService. REST schemas: API reference. Filter syntax: FQL.

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 alerts:read for query and get
  • alerts:write for PATCH status

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot query alerts (403) and cannot PATCH.

HTTP paths​

MethodPathUse
GET/alerts/queries/alerts/v2Query ids. Query: filter, limit, offset, sort (status.asc / severity.desc). Empty filter returns all ids.
POST/alerts/entities/alerts/v2Get alerts. Body { "composite_ids": [] }. Missing id → 200 with only found resources.
PATCH/alerts/entities/alerts/v3Update status. Body { "composite_ids": ["al-001"], "update_status": "closed" }.

Allowed FQL properties: status, severity, composite_id, device_id. Unknown property or invalid filter → 400.

Allowed update_status: new, in_progress, closed, reopened. Empty composite_ids or unknown status on PATCH → 400. Unknown composite_id on PATCH → 200 with empty resources.

Alert JSON: composite_id, device_id, status, severity, name.

Seed alerts​

composite_iddevice_idstatusseverityname
al-001aid-win-01newhighCredential dumping
al-002aid-lin-01newmediumSuspicious bash
al-003aid-win-02in_progresshighRansomware note
al-004aid-lin-02closedlowLocal recon
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 -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/alerts/queries/alerts/v2?filter=status:%27new%27'

Invalid FQL is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/alerts/queries/alerts/v2?filter=not-fql'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"composite_ids":["al-001","al-002"]}' \
http://127.0.0.1:8088/alerts/entities/alerts/v2
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"composite_ids":["al-001"],"update_status":"closed"}' \
http://127.0.0.1:8088/alerts/entities/alerts/v3

A later get of al-001 shows closed. PATCH requires alerts:write (or a session). A token with only alerts:read → 403.