Skip to main content

Response policies

Response policies is the Falcon Response Policy collection for this CID. Paths are under /policy/…. Combined response endpoints, clone_id on create, and add-rule-group / remove-rule-group are not implemented. iOS and Android platform_name are not implemented.

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

RPC field notes: ResponsePoliciesService. 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 response-policies:read for query, get, and members
  • response-policies:write for create, patch, delete, actions, and precedence

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot query response policies (403). There is no seeded client with response-policies:read — use the console cookie, or a client you created with that scope.

HTTP paths​

MethodPathUse
GET/policy/queries/response/v1Query ids. Query: filter, limit, offset, sort (name.asc / name.desc / precedence.asc). Empty filter returns all ids.
GET/policy/entities/response/v1?ids=Get policies. Missing id → 200 with only found resources.
POST/policy/entities/response/v1Create. Body { "name", "description", "platform_name" }. Optional settings. Empty name → 400. Unknown platform_name → 400. Success 201. Starts enabled false.
PATCH/policy/entities/response/v1Update. Body { "id", "name", "description", "settings" }. Does not change enabled — use actions.
DELETE/policy/entities/response/v1?ids=Delete policies.
GET/policy/queries/response-members/v1?id=Member device_ids (union of hosts in assigned groups).
POST/policy/entities/response-actions/v1?action_name=enable, disable, add-host-group, or remove-host-group. Body { "ids": ["resp-windows"], "group_id": "hg-linux" } at the top level. group_id is required for add/remove. Other action_name → 400. Unknown group → 400. Duplicate add is 200 (no-op).
POST/policy/entities/response-precedence/v1Body { "ids" } ordered. 400 if the set is not exactly all policies.

Allowed FQL properties: name, platform_name, enabled (match is lowercase). Unknown property or invalid filter → 400.

platform_name must be Windows, Linux, or Mac. Mac is accepted; this clone has no seeded Mac hosts.

Policy JSON: id, name, description, platform_name, enabled, precedence, settings (id + value.enabled), groups (assigned host group ids). Create ids are resp- plus 16 hex. Omitted settings on create uses the seed default { "id": "RealTimeResponse", "value": { "enabled": true } }.

Seed policies​

idnameplatform_nameenabledprecedencegroups
resp-windowsWindows responseWindowstrue1hg-windows
resp-linuxLinux responseLinuxtrue2hg-linux

Members of resp-windows include aid-win-01. Members of resp-linux include aid-lin-01.

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

Empty filter returns at least the two seed ids, including resp-windows. platform_name:'Windows' returns Windows rows:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/policy/queries/response/v1?filter=platform_name:%27Windows%27&sort=name.asc'

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/policy/queries/response/v1?filter=not-fql'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/policy/entities/response/v1?ids=resp-windows,resp-linux'

Each resource includes groups (assigned host group ids).

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"name":"Lab response","description":"lab","platform_name":"Windows"}' \
http://127.0.0.1:8088/policy/entities/response/v1

Success is 201. The new id is in resources. enabled is false. Empty name → 400. clone_id is ignored — it is not implemented.

curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"id":"resp-linux","name":"Linux response","description":"Linux endpoints"}' \
http://127.0.0.1:8088/policy/entities/response/v1
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/policy/entities/response/v1?ids=<policy-id>'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/policy/queries/response-members/v1?id=resp-linux'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"ids":["<policy-id>"]}' \
'http://127.0.0.1:8088/policy/entities/response-actions/v1?action_name=enable'

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"ids":["<policy-id>"],"group_id":"hg-linux"}' \
'http://127.0.0.1:8088/policy/entities/response-actions/v1?action_name=add-host-group'

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"ids":["<policy-id>"],"group_id":"hg-linux"}' \
'http://127.0.0.1:8088/policy/entities/response-actions/v1?action_name=remove-host-group'

add-rule-group and remove-rule-group are not implemented (action_name → 400).

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"ids":["resp-windows","resp-linux"]}' \
http://127.0.0.1:8088/policy/entities/response-precedence/v1

Create, patch, delete, actions, and precedence need response-policies:write (or a session). A token with only response-policies:read → 403 on those methods.

Query (Bearer)​

TOKEN='<access_token from a client with response-policies:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/policy/queries/response/v1'

response-policies: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.