Intel actors
Intel actors is the Falcon Intel collection for this CID — actors
query/get only. Paths are under /intel/…. Reports, malware, MITRE,
CAO, and combined are not implemented. There is no create or
patch. Intel indicators are a separate POST GET collection:
Intel indicators. Quarantine is a separate
collection: Quarantine.
This collection is not CrowdStrike production. It does not call Falcon cloud.
RPC field notes: IntelService. 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: Bearerwithintel:readfor query and get
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot query actors (403). Unit tests use a
client named cs-local-intel; that client is not in the production
seed. There is no seeded client with intel:read — use the console
cookie, or a client you created with that scope. Missing or revoked
token → 401.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /intel/queries/actors/v1 | Query actor ids. Query: filter, limit, offset, sort (name.asc / name.desc / slug.asc / status.asc / origin.asc and matching .desc). Empty filter returns all ids. |
GET | /intel/entities/actors/v1?ids= | Get actors. Missing id → 200 with only found resources. |
Allowed FQL properties: name, slug, status, origin (match is
lowercase). Unknown property or invalid filter → 400.
Actor JSON: id, name, slug, description, origin, status.
Seed actors
id | name | slug | origin | status |
|---|---|---|---|---|
actor-fancy-bear | FANCY BEAR | fancy-bear | russia | active |
actor-lab-bear | LAB BEAR | lab-bear | unknown | active |
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 actors (cookie)
Empty filter returns at least the seed ids actor-fancy-bear and
actor-lab-bear. slug:'fancy-bear' returns FANCY BEAR:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/intel/queries/actors/v1?filter=slug:%27fancy-bear%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/intel/queries/actors/v1?filter=not-fql'
Get actors (cookie)
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/intel/entities/actors/v1?ids=actor-fancy-bear'
Reports, malware, MITRE, CAO, and combined are not implemented. Custom IOC is a separate collection: IOC indicators. Custom IOA is a separate collection: Custom IOA. Intel indicators are a separate POST GET collection: Intel indicators. Spotlight is a separate collection: Spotlight. Quarantine is a separate collection: Quarantine.
Query (Bearer)
TOKEN='<access_token from a client with intel:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/intel/queries/actors/v1'
intel: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.