Installation tokens
Installation tokens is the Falcon Installation Tokens collection for this
CID. Paths are under /installation-tokens/…. Token audit-events are
not implemented. The token value is returned once on create.
List and get omit it.
This collection is not CrowdStrike production. It does not call Falcon cloud.
RPC field notes: InstallationTokensService. 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: Bearerwithinstallation-tokens:readfor query and getinstallation-tokens:writefor create, patch, and delete
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot query tokens (403). There is no seeded
client with installation-tokens:read — use the console cookie, or a
client you created with that scope.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /installation-tokens/queries/tokens/v1 | Query ids. Query: filter, limit, offset, sort (label.asc / label.desc). Empty filter returns all ids. |
GET | /installation-tokens/entities/tokens/v1?ids= | Get tokens (id, label, expires, type — no value). Missing id → 200 with only found resources. |
POST | /installation-tokens/entities/tokens/v1 | Create. Body { "label", "expires_timestamp" }. Empty label → 400. Success 201. value in the response once. |
PATCH | /installation-tokens/entities/tokens/v1 | Update. Body { "id", "label", "expires_timestamp" }. |
DELETE | /installation-tokens/entities/tokens/v1?ids= | Delete tokens. |
Allowed FQL properties: label. Unknown property or invalid filter →
400. Invalid expires_timestamp (not RFC3339) → 400.
Token JSON: id, label, expires_timestamp, type. Create also
returns value. type is customer.
Seed token
id | label | type | expires_timestamp |
|---|---|---|---|
tok-lab-1 | Default CID token | customer | 2027-01-01T00:00:00Z |
The seed value is hashed at insert and is not returned on list or get.
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 tokens (cookie)
Empty filter returns at least tok-lab-1.
label:'Default*' returns only the seed token:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/installation-tokens/queries/tokens/v1?filter=label:%27Default*%27&sort=label.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/installation-tokens/queries/tokens/v1?filter=not-fql'
Get tokens (cookie)
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/installation-tokens/entities/tokens/v1?ids=tok-lab-1'
The resource has id, label, expires_timestamp, and type. It does
not include value.
Create (cookie)
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"label":"Lab token","expires_timestamp":"2027-06-01T00:00:00Z"}' \
http://127.0.0.1:8088/installation-tokens/entities/tokens/v1
Success is 201. Copy id and value from resources. Empty
label → 400. A later GET of that id omits value.
Patch (cookie)
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"id":"tok-lab-1","label":"Default CID token","expires_timestamp":"2027-01-01T00:00:00Z"}' \
http://127.0.0.1:8088/installation-tokens/entities/tokens/v1
Delete (cookie)
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/installation-tokens/entities/tokens/v1?ids=<token-id>'
Create, patch, and delete need installation-tokens:write (or a
session). A token with only installation-tokens:read → 403 on
those methods.
Query (Bearer)
TOKEN='<access_token from a client with installation-tokens:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/installation-tokens/queries/tokens/v1'
installation-tokens: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.