Skip to main content

Container registries

Container registries is the Falcon Container registry-list collection for this CID — ReadRegistryEntities then ReadRegistryEntitiesByUUID, CreateRegistryEntities (SOURCE CreateRegistryEntities, PEP 8 create_registry_entities), DeleteRegistryEntities (SOURCE DeleteRegistryEntities, PEP 8 delete_registry_entities), and UpdateRegistryEntities (SOURCE UpdateRegistryEntities, PEP 8 update_registry_entities). The paths are GET /container-security/queries/registries/v1 and GET /container-security/entities/registries/v1. The Create POST path is POST /container-security/entities/registries/v1 (same path as GET entities, method POST). The Delete path is DELETE /container-security/entities/registries/v1 (same path as GET entities, method DELETE; distinct from GET queries, GET/POST/PATCH entities, DeleteImageDetails /entities/images/v1, Registry credentials, and Kubernetes). The Update PATCH path is PATCH /container-security/entities/registries/v1 (same path as GET entities, method PATCH; distinct from GET queries, GET/POST/DELETE entities, DeleteImageDetails /entities/images/v1, Registry credentials, and Kubernetes). Image assessment policies / remaining cloud, remaining Kubernetes Protection, remaining Container Images ops, remaining Container Vulnerabilities ops, and remaining CSPM are not implemented (not yet). This is not Container images (/container-security/combined/image-assessment/images/v1) and not Container vulnerabilities (/container-security/combined/vulnerabilities/v1). Registry credentials is a separate collection: Registry credentials. This is not Kubernetes (/kubernetes-protection/…). This is not the HelloService template sample (GET /api/hello).

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

RPC field notes: ContainerImagesService. REST schemas: API reference. Container registries use query then entities by ids, not FQL. POST create (/entities/registries/v1) uses JSON body {type, url, user_defined_alias}. Extra unused keys including credential, url_uniqueness_key, and parameters are ignored; the clone does not persist credentials. Clone success is JSON MSA 200 ContainerRegistry. Id DESIGN reg- + alias. Distinct from GET queries, GET/POST/PATCH/DELETE entities, DeleteImageDetails, Registry credentials, and Kubernetes. DELETE uses required query ids. Extra unused keys are ignored. DELETE does not cascade images. PATCH update (/entities/registries/v1) uses required query id and JSON body {user_defined_alias}. Extra unused keys including credential, state, and parameters are ignored; the clone does not persist credentials. PATCH does not change type, url, or cid. Clone PATCH success is JSON MSA 200 ContainerRegistry. Distinct from GET queries, GET/POST/DELETE entities, DeleteImageDetails, Registry credentials, and Kubernetes. Live curls must use -X PATCH (bare -d POSTs onto create).

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 falcon-container-image:read (GET) or falcon-container-image:write (POST, DELETE, PATCH)

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot list registries, create, delete, or update (403). falcon-container-image:read can list registries and cannot POST, DELETE, or PATCH (403). ReadRegistryEntities and ReadRegistryEntitiesByUUID stay falcon-container-image:read. Unit tests use a client named cs-local-cimg with falcon-container-image:read; that client can list registries and cannot POST, DELETE, or PATCH (403). Unit tests use a client named cs-local-cimgw with falcon-container-image:write; that client can POST, DELETE, and PATCH. It is not in the production seed. There is no seeded production client with falcon-container-image:read or falcon-container-image:write — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/container-security/queries/registries/v1Query ids. Query: limit, offset, sort.
GET/container-security/entities/registries/v1?ids=Get registries for those ids. Empty ids → 400.
POST/container-security/entities/registries/v1Create a registry. RPC CreateRegistryEntities. SOURCE CreateRegistryEntities. PEP 8 create_registry_entities. Body JSON {type, url, user_defined_alias}. Distinct from GET queries, GET entities, PATCH update, DELETE, DeleteImageDetails, Registry credentials, and Kubernetes. Success 200 MSA ContainerRegistry. Extra unused keys ignored. Required type, url, user_defined_alias. Clone does not persist credential. Id reg- + alias. falcon-container-image:write.
DELETE/container-security/entities/registries/v1?ids=Delete registries. RPC DeleteRegistryEntities. SOURCE DeleteRegistryEntities. PEP 8 delete_registry_entities. Query ids. Distinct from GET queries, GET/POST/PATCH entities, DeleteImageDetails, Registry credentials, and Kubernetes. Success 200 MSA ContainerRegistry. Extra unused keys ignored. Required ids. falcon-container-image:write. Does not cascade images.
PATCH/container-security/entities/registries/v1?id=Update a registry alias. RPC UpdateRegistryEntities. SOURCE UpdateRegistryEntities. PEP 8 update_registry_entities. Query id. Body JSON {user_defined_alias}. Distinct from GET queries, GET/POST/DELETE entities, DeleteImageDetails, Registry credentials, and Kubernetes. Success 200 MSA ContainerRegistry. Extra unused keys ignored. Required query id + body user_defined_alias. Clone does not persist credential. Does not change type/url. falcon-container-image:write. Live curls must use -X PATCH.

There is no filter. Query then pass the returned ids on the entities path. limit and offset must be ≥ 0 else 400. Omitted limit defaults to 100 (capped at 100). Default sort is id ascending. Unknown ids are omitted from resources (empty list 200, not 404).

JSON is SOURCE snake_case: id, type, url, user_defined_alias, cid.

POST create body JSON {type, url, user_defined_alias} on /entities/registries/v1 (distinct from GET queries, GET entities same path, PATCH update, DELETE, DeleteImageDetails, Registry credentials, and Kubernetes). Missing type → 400 type is required. Missing url → 400 url is required. Missing user_defined_alias → 400 user_defined_alias is required. Duplicate url → 400 url already exists. Duplicate user_defined_alias (or existing id) → 400 user_defined_alias already exists. Extra unused keys including credential, url_uniqueness_key, and parameters are ignored; the clone does not persist credentials. Clone success is 200 MSA ContainerRegistry (not SOURCE 201). POST type=docker / url=quay.io / user_defined_alias=lab-quay returns id reg-lab-quay. falcon-container-image:read on POST → 403. cs-local-hosts on POST → 403. This is not GET queries, not GET entities, not PATCH update, not DELETE, not DeleteImageDetails, not Registry credentials, and not Kubernetes.

DELETE query ids on /entities/registries/v1 (distinct from GET queries, GET/POST/PATCH entities, DeleteImageDetails /entities/images/v1, Registry credentials, and Kubernetes). Missing ids → 400 ids is required. Unknown ids → 404. Extra unused query keys are ignored. Clone success is 200 MSA ContainerRegistry. DELETE ids=reg-lab-2 returns that row then removes it. GET entities after DELETE ids=reg-lab-2 is empty; ids=reg-lab-1 remains. DELETE does not cascade images. falcon-container-image:read on DELETE → 403. cs-local-hosts on DELETE → 403. This is not GET queries, not GET/POST/PATCH entities, not DeleteImageDetails, not Registry credentials, and not Kubernetes.

PATCH update query id and body {user_defined_alias} on /entities/registries/v1 (distinct from GET queries, GET/POST/DELETE entities, DeleteImageDetails /entities/images/v1, Registry credentials, and Kubernetes). Missing id → 400 id is required. Missing user_defined_alias → 400 user_defined_alias is required. Unknown id → 404 unknown registry id. Duplicate user_defined_alias (another row, e.g. lab-ghcr if reg-lab-2 exists) → 400 user_defined_alias already exists. Same id updating to its current alias is OK. Extra unused keys including credential, state, and parameters are ignored; the clone does not persist credentials. PATCH does not change type, url, or cid. Clone success is 200 MSA ContainerRegistry. PATCH id=reg-lab-1 / user_defined_alias=lab-docker-b returns that row with alias lab-docker-b; type stays docker and url stays docker.io. GET entities after PATCH ids=reg-lab-1 matches. falcon-container-image:read on PATCH → 403. cs-local-hosts on PATCH → 403. Live curls must use -X PATCH. This is not GET queries, not GET/POST/DELETE entities, not DeleteImageDetails, not Registry credentials, and not Kubernetes.

This is not Container images, Container vulnerabilities, or the HelloService template. Container images uses /container-security/combined/image-assessment/images/v1: Container images. Combined container vulnerabilities uses /container-security/combined/vulnerabilities/v1: Container vulnerabilities. Registry credentials uses /container-security/entities/image-registry-credentials/v1: Registry credentials. DeleteImageDetails uses /container-security/entities/images/v1: Container images. Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet).

Seed registries​

idtypeurluser_defined_alias
reg-lab-1dockerdocker.iolab-docker
reg-lab-2dockerghcr.iolab-ghcr

cid is cid-local-1. Query returns both ids. Entities ids=reg-lab-1 returns that row. POST create with type=docker / url=quay.io / user_defined_alias=lab-quay adds reg-lab-quay. reg-lab-quay is not a seed. GET entities ids=reg-lab-quay after POST matches that row. DELETE ids=reg-lab-2 removes that row. GET entities after DELETE ids=reg-lab-2 is empty; ids=reg-lab-1 remains. DELETE does not cascade images. PATCH id=reg-lab-1 / user_defined_alias=lab-docker-b updates that alias. GET entities after PATCH ids=reg-lab-1 matches alias lab-docker-b; type and url stay docker / docker.io. PATCH does not persist credential.

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 returns at least the two seed ids, including reg-lab-1:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/queries/registries/v1'

ids=reg-lab-1 returns that row:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-1'

Empty ids 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/container-security/entities/registries/v1'

No cookie and no Bearer is 401:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/queries/registries/v1'

POST type=docker / url=quay.io / user_defined_alias=lab-quay on /entities/registries/v1 returns that registry with id reg-lab-quay. Success is 200 MSA ContainerRegistry. This is not GET queries, not GET entities, not PATCH update, not DELETE, not DeleteImageDetails, not Registry credentials, and not Kubernetes. Extra unused keys including credential are ignored; the clone does not persist credentials:

curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay","credential":"ignored"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

GET after POST matches that row:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-quay'

Duplicate url is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay-2"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

Duplicate user_defined_alias is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io/lab","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

Missing type is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

Missing url is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

Missing user_defined_alias is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

cs-local-hosts (hosts:read only) is 403 on POST:

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

falcon-container-image:read (cs-local-cimg) is 403 on POST:

TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

No cookie and no Bearer is 401 on POST:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Container images is a separate collection: Container images. Combined container vulnerabilities is a separate collection: Container vulnerabilities. Registry credentials is a separate collection: Registry credentials. This is not DeleteImageDetails (/entities/images/v1). This is not Kubernetes. This is not the HelloService template (GET /api/hello).

DELETE ids=reg-lab-2 on /entities/registries/v1 returns that registry. Success is 200 MSA ContainerRegistry. GET entities after DELETE ids=reg-lab-2 is empty; ids=reg-lab-1 remains. This is not GET queries, not GET/POST/PATCH entities, not DeleteImageDetails, not Registry credentials, and not Kubernetes. Extra unused query keys including foo are ignored. DELETE does not cascade images:

curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2&foo=bar'

GET entities after DELETE ids=reg-lab-2 is empty:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'

GET entities ids=reg-lab-1 still present:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-1'

Missing ids is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

Unknown ids is 404:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-missing'

cs-local-hosts (hosts:read only) is 403 on DELETE:

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'

falcon-container-image:read (cs-local-cimg) is 403 on DELETE:

TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'

No cookie and no Bearer is 401 on DELETE:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Container images is a separate collection: Container images. Combined container vulnerabilities is a separate collection: Container vulnerabilities. Registry credentials is a separate collection: Registry credentials. This is not DeleteImageDetails (/entities/images/v1). This is not Kubernetes. This is not the HelloService template (GET /api/hello).

PATCH id=reg-lab-1 / user_defined_alias=lab-docker-b on /entities/registries/v1 returns that registry with alias lab-docker-b. Success is 200 MSA ContainerRegistry. GET entities after PATCH ids=reg-lab-1 matches. Type stays docker and url stays docker.io. This is not GET queries, not GET/POST/DELETE entities, not DeleteImageDetails, not Registry credentials, and not Kubernetes. Required query id + body user_defined_alias. Extra unused keys including credential, state, and parameters are ignored; the clone does not persist credentials. PATCH does not change type, url, or cid. Live curls must use -X PATCH (bare -d POSTs onto create):

curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b","credential":"ignored","state":"ignored","parameters":"ignored"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'

GET entities after PATCH matches alias lab-docker-b:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-1'

Missing id is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

Missing user_defined_alias is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'

Unknown id is 404:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-missing'

Duplicate user_defined_alias (lab-ghcr if reg-lab-2 exists) is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-ghcr"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'

cs-local-hosts (hosts:read only) is 403 on PATCH:

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'

falcon-container-image:read (cs-local-cimg) is 403 on PATCH:

TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'

No cookie and no Bearer is 401 on PATCH:

curl -sS -o /dev/null -w '%{http_code}\n' \
-X PATCH -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Container images is a separate collection: Container images. Combined container vulnerabilities is a separate collection: Container vulnerabilities. Registry credentials is a separate collection: Registry credentials. This is not DeleteImageDetails (/entities/images/v1). This is not Kubernetes. This is not the HelloService template (GET /api/hello).

Query (Bearer)​

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

falcon-container-image:read → 200 (including unit-test client cs-local-cimg). A token without that scope (including hosts:read only, e.g. cs-local-hosts) → 403. Missing or revoked token → 401. ReadRegistryEntities stays falcon-container-image:read.

Create (Bearer)​

TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"type":"docker","url":"quay.io","user_defined_alias":"lab-quay"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1'

falcon-container-image:write → 200 on POST (including unit-test client cs-local-cimgw). A token without that scope (including hosts:read only, e.g. cs-local-hosts, or falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing or revoked token → 401. There is no seeded production client with falcon-container-image:write — use the console cookie, or a client you created with that scope. CreateRegistryEntities stays falcon-container-image:write. PEP 8 create_registry_entities. Distinct from GET queries, GET entities, PATCH update, DELETE, DeleteImageDetails, Registry credentials, and Kubernetes.

Delete (Bearer)​

TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/registries/v1?ids=reg-lab-2'

falcon-container-image:write → 200 on DELETE (including unit-test client cs-local-cimgw). A token without that scope (including hosts:read only, e.g. cs-local-hosts, or falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing or revoked token → 401. There is no seeded production client with falcon-container-image:write — use the console cookie, or a client you created with that scope. DeleteRegistryEntities stays falcon-container-image:write. PEP 8 delete_registry_entities. Distinct from GET queries, GET/POST/PATCH entities, DeleteImageDetails, Registry credentials, and Kubernetes. DELETE does not cascade images.

Update (Bearer)​

TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"user_defined_alias":"lab-docker-b"}' \
'http://127.0.0.1:8088/container-security/entities/registries/v1?id=reg-lab-1'

falcon-container-image:write → 200 on PATCH (including unit-test client cs-local-cimgw). A token without that scope (including hosts:read only, e.g. cs-local-hosts, or falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing or revoked token → 401. There is no seeded production client with falcon-container-image:write — use the console cookie, or a client you created with that scope. UpdateRegistryEntities stays falcon-container-image:write. SOURCE UpdateRegistryEntities. PEP 8 update_registry_entities. Distinct from GET queries, GET/POST/DELETE entities, DeleteImageDetails, Registry credentials, and Kubernetes. Required query id + body user_defined_alias. Extra unused keys ignored. The clone does not persist credential. PATCH does not change type or url. Live curls must use -X PATCH. Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet).

OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.