IOC indicators
IOC indicators is the Falcon IOC collection for this CID. Paths are under
/iocs/…. Combined endpoints, aggregates, devices_ran_on,
processes_ran_on, SDMF, reports, action catalog,
type/platform/severity query helpers, legacy
/indicators/entities/iocs/v1, and the Falcon create envelope
indicators[] are not implemented.
This collection is not CrowdStrike production. It does not call Falcon cloud.
RPC field notes: IocService. 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: Bearerwithioc:readfor query and getioc:writefor create, patch, and delete
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot query indicators (403). Unit tests use a
client named cs-local-iocs; that client is not in the production
seed. There is no seeded client with ioc:read — use the console
cookie, or a client you created with that scope.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /iocs/queries/indicators/v1 | Query ids. Query: filter, limit, offset, sort (type.asc / type.desc / value.asc / action.asc / severity.asc and matching .desc). Empty filter returns all ids. |
GET | /iocs/entities/indicators/v1?ids= | Get indicators. Missing id → 200 with only found resources. |
POST | /iocs/entities/indicators/v1 | Create. Body { "type", "value", "action", "severity", "description", "platforms", "applied_globally" } at the top level — not Falcon indicators[]. Empty value → 400. Unknown type → 400. Success 201. |
PATCH | /iocs/entities/indicators/v1 | Update. Body { "id", "action", "severity", "description" }. |
DELETE | /iocs/entities/indicators/v1?ids= | Delete indicators. |
Allowed FQL properties: type, value, action, severity (match is
lowercase). Unknown property or invalid filter → 400.
type must be sha256, md5, domain, or ipv4. action must be
detect or prevent. severity must be low, medium, high, or
critical. Unknown action or severity → 400.
Indicator JSON: id, type, value, action, severity, platforms,
description, applied_globally. Create ids are ioc- plus 16 hex.
Seed indicators
id | type | value | action | severity | description |
|---|---|---|---|---|---|
ioc-domain-1 | domain | adversary.example.invalid | detect | high | Lab domain |
ioc-sha256-1 | sha256 | 64×a | detect | medium | Lab SHA256 |
Both seeds have applied_globally true and empty platforms.
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 indicators (cookie)
Empty filter returns at least the two seed ids, including ioc-domain-1.
type:'domain' returns the domain row:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/iocs/queries/indicators/v1?filter=type:%27domain%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/iocs/queries/indicators/v1?filter=not-fql'
Get indicators (cookie)
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/iocs/entities/indicators/v1?ids=ioc-domain-1,ioc-sha256-1'
Create (cookie)
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"domain","value":"lab.example.invalid","action":"detect","severity":"medium","description":"lab","platforms":["windows"],"applied_globally":true}' \
http://127.0.0.1:8088/iocs/entities/indicators/v1
Success is 201. The new id is in resources. Empty value →
400. Falcon indicators[] is not implemented — send fields at
the top level.
Patch (cookie)
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"id":"ioc-domain-1","action":"prevent","severity":"critical","description":"patched"}' \
http://127.0.0.1:8088/iocs/entities/indicators/v1
Delete (cookie)
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/iocs/entities/indicators/v1?ids=<indicator-id>'
Create, patch, and delete need ioc:write (or a session). A token with
only ioc:read → 403 on those methods.
Combined, aggregates, devices_ran_on, processes_ran_on, SDMF,
reports, type/platform/severity query helpers, and legacy
/indicators/entities/iocs/v1 are not implemented. Custom IOA is a
separate collection: Custom IOA. Intel actors are
a separate /intel/… collection (not custom IOC):
Intel actors. Intel indicators are a separate
POST GET /intel/… collection — not custom IOC /iocs/…:
Intel indicators.
Query (Bearer)
TOKEN='<access_token from a client with ioc:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/iocs/queries/indicators/v1'
ioc: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.