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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithalerts:readfor query and getalerts:writefor 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
| Method | Path | Use |
|---|---|---|
GET | /alerts/queries/alerts/v2 | Query ids. Query: filter, limit, offset, sort (status.asc / severity.desc). Empty filter returns all ids. |
POST | /alerts/entities/alerts/v2 | Get alerts. Body { "composite_ids": [] }. Missing id → 200 with only found resources. |
PATCH | /alerts/entities/alerts/v3 | Update 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_id | device_id | status | severity | name |
|---|---|---|---|---|
al-001 | aid-win-01 | new | high | Credential dumping |
al-002 | aid-lin-01 | new | medium | Suspicious bash |
al-003 | aid-win-02 | in_progress | high | Ransomware note |
al-004 | aid-lin-02 | closed | low | Local recon |
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
Query alerts (cookie)
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'
Get alerts (cookie)
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
Patch status (cookie)
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.