Event streams
Event streams is the data-feed discovery collection for this CID —
list available streams and refresh the active session. Paths are
GET /sensors/entities/datafeed/v2 and
POST /sensors/entities/datafeed-actions/v1/{partition}. Streaming,
SSE, HTTP long-poll, and Next-Gen SIEM are not implemented. This is
not Sensor installers (/sensors/queries/installers).
This collection is not CrowdStrike production. It does not call Falcon cloud. It is not Falcon streaming.
RPC field notes:
EventStreamsService.
REST schemas: API reference. Event streams uses appId, not
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: Bearerwithevent-streams:readfor list and refresh
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list streams (403). There is no seeded
client with event-streams:read — use the console cookie, or a client
you created with that scope. Missing or revoked token → 401.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /sensors/entities/datafeed/v2 | List streams. Query: appId (required), format (json / flatjson / omitted). |
POST | /sensors/entities/datafeed-actions/v1/{partition} | Refresh. Query: action_name=refresh_active_stream_session, appId. |
appId must match [A-Za-z0-9-]{1,32} (hyphen allowed so seed
cs-local-1 is valid). Missing appId → 400. Unknown appId on
list → 200 with empty resources. Other format → 400.
action_name other than refresh_active_stream_session → 400.
Unknown partition or unknown appId on refresh → 404. Empty
appId on refresh → 400.
JSON is SOURCE camelCase: dataFeedURL,
refreshActiveSessionInterval, refreshActiveSessionURL,
sessionToken.token, sessionToken.expiration.
This is not Sensor installers, Real Time Response, Kubernetes, or
Next-Gen SIEM. Sensor installers use /sensors/queries/installers:
Sensors. Real Time Response uses /real-time-response/…:
Real Time Response. Kubernetes Protection uses
/kubernetes-protection/entities/kubernetes/clusters/v1:
Kubernetes. Next-Gen SIEM is not
implemented.
Seed stream
appId | partition | interval | token |
|---|---|---|---|
cs-local-1 | 0 | 1800 | tok-stream-lab-1 |
dataFeedURL is
http://crowdstrike-api.localhost:8088/sensors/entities/datafeed/v2?appId=cs-local-1
(discovery URL, not a Falcon stream host).
refreshActiveSessionURL is
http://crowdstrike-api.localhost:8088/sensors/entities/datafeed-actions/v1/0?action_name=refresh_active_stream_session&appId=cs-local-1.
refreshActiveSessionInterval is 1800. Refresh persists a new
tok- token and expiration (RFC3339, now + 1800s).
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
List streams (cookie)
appId=cs-local-1 returns at least the seed resource with dataFeedURL
and sessionToken.token:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/sensors/entities/datafeed/v2?appId=cs-local-1'
Missing appId 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/sensors/entities/datafeed/v2'
Unknown appId is 200 with empty resources:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/sensors/entities/datafeed/v2?appId=unknown-app'
Bad format 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/sensors/entities/datafeed/v2?appId=cs-local-1&format=xml'
Refresh (cookie)
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/sensors/entities/datafeed-actions/v1/0?action_name=refresh_active_stream_session&appId=cs-local-1'
Success is 200 and includes the updated stream resource. Bad
action_name is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/sensors/entities/datafeed-actions/v1/0?action_name=is&appId=cs-local-1'
Unknown partition is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/sensors/entities/datafeed-actions/v1/99?action_name=refresh_active_stream_session&appId=cs-local-1'
Streaming, SSE, and Next-Gen SIEM are not implemented. Sensor installers are a separate collection: Sensors. Real Time Response is a separate collection: Real Time Response. Kubernetes Protection is a separate collection: Kubernetes.
List (Bearer)
TOKEN='<access_token from a client with event-streams:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/sensors/entities/datafeed/v2?appId=cs-local-1'
event-streams:read → 200. A token without that scope (including
hosts:read only) → 403. Missing or revoked token → 401.
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.