Skip to main content

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_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with event-streams:read for 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​

MethodPathUse
GET/sensors/entities/datafeed/v2List 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​

appIdpartitionintervaltoken
cs-local-101800tok-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).

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

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'
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.