Skip to main content

CSPM AWS

CSPM AWS is the AWS-account-list collection for this CID — GetCSPMAwsAccount, CreateAwsAccount (PEP 8 create_aws_account), PatchAwsAccount (SOURCE PatchCSPMAwsAccount, PEP 8 update_aws_account), DeleteAwsAccount (SOURCE DeleteCSPMAwsAccount, PEP 8 delete_aws_account), AWS user-script metadata — GetAwsAccountScriptsAttachment (SOURCE GetCSPMAwsAccountScriptsAttachment, PEP 8 get_aws_account_scripts_attachment), and clone-local console setup URLs — GetAwsConsoleSetupURLs (SOURCE GetCSPMAwsConsoleSetupURLs, PEP 8 get_aws_console_setup_urls). The path is GET /cloud-connect-cspm-aws/entities/account/v1, POST /cloud-connect-cspm-aws/entities/account/v1, PATCH /cloud-connect-cspm-aws/entities/account/v1, and DELETE /cloud-connect-cspm-aws/entities/account/v1 (same path, method DELETE). The scripts-attachment path is GET /cloud-connect-cspm-aws/entities/user-scripts-download/v1. The console-setup-urls path is GET /cloud-connect-cspm-aws/entities/console-setup-urls/v1. Image assessment policies / remaining cloud and other cloud/container collections are not implemented (not yet). This is not Kubernetes AWS (/kubernetes-protection/entities/accounts/aws/v1) and not Cloud GCP Connect (/cloud-connect-cspm-gcp/entities/account/v2). This is not Kubernetes (/kubernetes-protection/…) and not Hosts (/devices/…). This is not a grant-script file download. CSPM Azure is a separate collection: CSPM Azure. CSPM GCP is a separate collection: CSPM GCP. Kubernetes AWS is a separate collection: K8s AWS.

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

RPC field notes: CspmRegistrationService. REST schemas: API reference. CSPM AWS uses query params, not FQL. POST create uses JSON body {account_id, cloudtrail_region}. Extra unused keys are ignored; the clone does not emit AWS grant scripts. Clone success is JSON MSA 200 CspmAwsAccount, not SOURCE 201/207. PATCH uses JSON body {account_id, cloudtrail_region}. Extra unused body keys are ignored. Required account_id, cloudtrail_region. Clone PATCH success is JSON MSA 200 CspmAwsAccount. PATCH is not Kubernetes AWS update (/kubernetes-protection/entities/accounts/aws/v1) and not CreateAwsAccount. PATCH PEP 8 update_aws_account is not Kubernetes AWS UpdateAWSAccount. DELETE uses query ids (required) and an empty body. Extra unused query keys (organization-ids, parameters) are ignored. There is no organization-ids delete this slice. Clone DELETE success is 200 empty resources, not SOURCE 201/207. DELETE is not Kubernetes AWS delete (/kubernetes-protection/entities/accounts/aws/v1). GetAwsAccountScriptsAttachment uses query params ids, template, and account_type, not FQL. Extra unused query keys (accounts, parameters) are ignored. Clone success is JSON MSA 200 CspmAwsScriptAttachment (template, ids, account_type, note), not a grant-script file download and not application/octet-stream. The clone does not emit AWS grant scripts. Distinct from GET account /cloud-connect-cspm-aws/entities/account/v1. GetAwsConsoleSetupURLs uses query params ids, use_existing_cloudtrail, region, tags, and template, not FQL. Extra unused query keys (use_existing_cloudtrail, region, tags, template, parameters) are ignored. Clone success is JSON MSA 200 CspmAwsConsoleSetupUrl (account_id, url). url is clone-local /cspm-aws-accounts/{account_id}, not a live AWS IAM grant URL and not a grant-script file download. Distinct from GET account /cloud-connect-cspm-aws/entities/account/v1 and user-scripts-download /cloud-connect-cspm-aws/entities/user-scripts-download/v1. The clone does not emit AWS grant scripts. This is not Kubernetes AWS.

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 cspm-registration:read (GET) or cspm-registration:write (POST, PATCH, and DELETE)

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot list accounts, download scripts, list setup URLs, create, patch, or delete (403). cspm-registration:read can list accounts, download scripts, and list setup URLs and cannot POST, PATCH, or DELETE (403). GetAwsAccount stays cspm-registration:read. GetAwsAccountScriptsAttachment stays cspm-registration:read. GetAwsConsoleSetupURLs stays cspm-registration:read. CreateAwsAccount, PatchAwsAccount, and DeleteAwsAccount need cspm-registration:write. There is no product-seeded write client — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/cloud-connect-cspm-aws/entities/account/v1List accounts. Query: ids, status (provisioned | operational), limit, offset.
GET/cloud-connect-cspm-aws/entities/user-scripts-download/v1Download AWS user-script metadata. RPC GetAwsAccountScriptsAttachment. PEP 8 get_aws_account_scripts_attachment. Query: optional ids, template (aws-bash | aws-terraform), account_type (commercial | gov). Success 200 MSA CspmAwsScriptAttachment (template, ids, account_type, note). Extra unused query keys ignored. Distinct from GET account /entities/account/v1, Kubernetes AWS, grant-script file download. Clone does not emit AWS grant scripts.
GET/cloud-connect-cspm-aws/entities/console-setup-urls/v1List clone-local AWS console setup URLs. RPC GetAwsConsoleSetupURLs. SOURCE GetCSPMAwsConsoleSetupURLs. PEP 8 get_aws_console_setup_urls. Query: optional ids. Success 200 MSA CspmAwsConsoleSetupUrl (account_id, url). Extra unused query keys ignored. Distinct from GET account /entities/account/v1, user-scripts-download, Kubernetes AWS, grant-script file download. Clone-local url /cspm-aws-accounts/{account_id}. Clone does not emit AWS grant scripts.
POST/cloud-connect-cspm-aws/entities/account/v1Create AWS account. RPC CreateAwsAccount. Body JSON {account_id, cloudtrail_region}. Success 200 MSA CspmAwsAccount.
PATCH/cloud-connect-cspm-aws/entities/account/v1Patch AWS account CloudTrail region. RPC PatchAwsAccount. SOURCE PatchCSPMAwsAccount. PEP 8 update_aws_account. Body JSON {account_id, cloudtrail_region}. Success 200 MSA CspmAwsAccount. Extra unused body keys ignored. Distinct from Kubernetes AWS update /kubernetes-protection/entities/accounts/aws/v1 and CreateAwsAccount POST.
DELETE/cloud-connect-cspm-aws/entities/account/v1Delete AWS account. RPC DeleteAwsAccount. Query: ids (required). Empty body. Success 200 empty resources.

Filters are exact match. Empty query params return every account in this CID. status other than provisioned or operational → 400. limit and offset must be ≥ 0 else 400. Omitted limit defaults to 100 (capped at 500). Repeated ids / status: OR within a field, AND across fields.

POST body JSON {account_id, cloudtrail_region}. Missing account_id or cloudtrail_region → 400. Duplicate account_id → 400. Extra unused keys are ignored; the clone does not emit AWS grant scripts. Clone success is 200 MSA CspmAwsAccount (not SOURCE 201/207). POST account_id=333333333333 / cloudtrail_region=us-west-2 returns that account with status provisioned. cspm-registration:read on POST → 403. cs-local-hosts on POST → 403.

PATCH body JSON {account_id, cloudtrail_region}. Missing account_id or cloudtrail_region → 400. Unknown account_id → 404. Extra unused body keys (iam_role_arn, behavior_assessment_enabled, resources, remediation_region, parameters) are ignored. Clone success is 200 MSA CspmAwsAccount. PATCH account_id=111111111111 / cloudtrail_region=us-west-1 returns that account with cloudtrail_region us-west-1. Organization, status, IAM role, and account type stay unchanged. GET ids=111111111111 after PATCH is that region. cspm-registration:read on PATCH → 403. cs-local-hosts on PATCH → 403. This is not Kubernetes AWS update PATCH /kubernetes-protection/entities/accounts/aws/v1 and not CreateAwsAccount.

DELETE query ids (empty body). ids is required; missing ids → 400. Unknown account id → 400. Extra unused query keys (organization-ids, parameters) are ignored. There is no organization-ids delete this slice. Clone success is 200 empty resources (not SOURCE 201/207). GET ids=333333333333 after DELETE is empty. A second DELETE of the same id → 400. If several ids are sent and any is unknown or empty, 400 and no row is deleted. cspm-registration:read on DELETE → 403. cs-local-hosts on DELETE → 403. Do not seed 333333333333. This is not Kubernetes AWS DELETE /kubernetes-protection/entities/accounts/aws/v1.

Empty ids on GetAwsAccountScriptsAttachment uses every stored AWS account id (order account_id ASC). ids=111111111111 returns that id only. Unknown id → 400 unknown aws account id. Empty template defaults aws-bash. Allowed templates aws-bash | aws-terraform; unknown → 400 unknown template. Empty account_type defaults commercial. Allowed commercial | gov; unknown → 400 unknown account_type. Extra unused query keys (accounts, parameters) are ignored. note is always This clone does not emit AWS grant scripts. There is no content script field. Success is JSON MSA 200, not application/octet-stream. Distinct from GET account /cloud-connect-cspm-aws/entities/account/v1, Kubernetes AWS, and grant-script file download.

Empty ids on GetAwsConsoleSetupURLs uses every stored AWS account id (order account_id ASC). ids=111111111111 returns that id only. Unknown id → 400 unknown aws account id. Extra unused query keys (use_existing_cloudtrail, region, tags, template, parameters) are ignored. Each resource is account_id and clone-local url /cspm-aws-accounts/{account_id}. Success is JSON MSA 200, not a live AWS IAM grant URL and not application/octet-stream. Distinct from GET account /cloud-connect-cspm-aws/entities/account/v1, user-scripts-download /cloud-connect-cspm-aws/entities/user-scripts-download/v1, Kubernetes AWS, and grant-script file download.

JSON is SOURCE snake_case: account_id, organization_id, iam_role_arn, status, account_type, cloudtrail_region, cid. Scripts JSON is template, ids, account_type, note. Setup URL JSON is account_id, url.

This is not Kubernetes AWS, Cloud GCP Connect, Kubernetes, or Hosts. Kubernetes AWS uses /kubernetes-protection/entities/accounts/aws/v1: K8s AWS. Cloud GCP Connect uses /cloud-connect-cspm-gcp/entities/account/v2: CSPM GCP. Kubernetes uses /kubernetes-protection/entities/kubernetes/clusters/v1: Kubernetes. Hosts uses /devices/…: Hosts. Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). CSPM Azure uses /cloud-connect-cspm-azure/entities/account/v1: CSPM Azure.

Seed accounts​

account_idorganization_idstatusaccount_typecloudtrail_regioniam_role_arn
111111111111o-laborg1operationalcommercialus-east-1arn:aws:iam::111111111111:role/CrowdStrikeFalcon
222222222222o-laborg2provisionedcommercialeu-west-1arn:aws:iam::222222222222:role/CrowdStrikeFalcon

cid is cid-local-1. Empty filters return both. status=operational returns 111111111111. ids=111111111111 returns that row. POST create with 333333333333 / us-west-2 adds that row with status provisioned. PATCH 111111111111 / us-west-1 updates that row's CloudTrail region. GET after PATCH is us-west-1. DELETE ids=333333333333 removes that row. GET after DELETE is empty. Empty scripts ids returns template aws-bash and both seed ids. ids=111111111111 on scripts returns that id only. Empty setup ids returns both seed ids with clone-local urls /cspm-aws-accounts/111111111111 and /cspm-aws-accounts/222222222222. ids=111111111111 on setup URLs returns that id only.

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 filters return at least the two seed ids, including 111111111111:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

status=operational returns 111111111111:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?status=operational'

ids=111111111111 returns that row:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=111111111111'

Unknown status 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/cloud-connect-cspm-aws/entities/account/v1?status=bogus'

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/cloud-connect-cspm-aws/entities/account/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Kubernetes AWS is a separate collection (/kubernetes-protection/entities/accounts/aws/v1): K8s AWS. Cloud GCP Connect is a separate collection (/cloud-connect-cspm-gcp/entities/account/v2): CSPM GCP. Kubernetes is a separate collection: Kubernetes. Hosts is a separate collection: Hosts. CSPM Azure is a separate collection: CSPM Azure. CSPM GCP is a separate collection: CSPM GCP.

Empty ids returns template aws-bash, ids 111111111111 and 222222222222, and note This clone does not emit AWS grant scripts. Success is 200 MSA CspmAwsScriptAttachment. Extra unused query keys are ignored. This is not GET account (/cloud-connect-cspm-aws/entities/account/v1), not Kubernetes AWS, and not a grant-script file download. The clone does not emit AWS grant scripts:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'

ids=111111111111 returns that id only:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1?ids=111111111111'

Unknown account id 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/cloud-connect-cspm-aws/entities/user-scripts-download/v1?ids=999999999999'

Unknown template 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/cloud-connect-cspm-aws/entities/user-scripts-download/v1?template=bogus'

Extra unused query keys are ignored (accounts does not change the metadata):

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1?accounts=ignored'

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

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'

No cookie and no Bearer is 401 on GET:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Kubernetes AWS is a separate collection (/kubernetes-protection/entities/accounts/aws/v1): K8s AWS. Cloud GCP Connect is a separate collection (/cloud-connect-cspm-gcp/entities/account/v2): CSPM GCP. Kubernetes is a separate collection: Kubernetes. Hosts is a separate collection: Hosts. CSPM Azure is a separate collection: CSPM Azure.

Empty ids returns 111111111111 and 222222222222 with clone-local url /cspm-aws-accounts/111111111111 and /cspm-aws-accounts/222222222222. Success is 200 MSA CspmAwsConsoleSetupUrl. Extra unused query keys are ignored. This is not GET account (/cloud-connect-cspm-aws/entities/account/v1), not user-scripts-download (/cloud-connect-cspm-aws/entities/user-scripts-download/v1), not Kubernetes AWS, and not a grant-script file download. The clone does not emit AWS grant scripts. url is not a live AWS IAM grant URL:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'

ids=111111111111 returns that id only:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1?ids=111111111111'

Unknown account id 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/cloud-connect-cspm-aws/entities/console-setup-urls/v1?ids=999999999999'

Extra unused query keys are ignored (template does not change the urls):

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1?template=ignored'

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

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'

No cookie and no Bearer is 401 on GET:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Kubernetes AWS is a separate collection (/kubernetes-protection/entities/accounts/aws/v1): K8s AWS. Cloud GCP Connect is a separate collection (/cloud-connect-cspm-gcp/entities/account/v2): CSPM GCP. Kubernetes is a separate collection: Kubernetes. Hosts is a separate collection: Hosts. CSPM Azure is a separate collection: CSPM Azure.

POST account_id=333333333333 / cloudtrail_region=us-west-2 returns that account with status provisioned. Success is 200 MSA CspmAwsAccount:

curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Duplicate account_id 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 '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Missing account_id 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 '{"cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Missing cloudtrail_region 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 '{"account_id":"333333333333"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/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 '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/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 '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Kubernetes AWS is a separate collection (/kubernetes-protection/entities/accounts/aws/v1): K8s AWS. Cloud GCP Connect is a separate collection (/cloud-connect-cspm-gcp/entities/account/v2): CSPM GCP. Kubernetes is a separate collection: Kubernetes. Hosts is a separate collection: Hosts. CSPM Azure is a separate collection: CSPM Azure.

PATCH account_id=111111111111 / cloudtrail_region=us-west-1 returns that account with CloudTrail region us-west-1. Success is 200 MSA CspmAwsAccount. Extra unused body keys are ignored. This is not Kubernetes AWS update (PATCH /kubernetes-protection/entities/accounts/aws/v1) and not CreateAwsAccount. GET ids=111111111111 after PATCH is us-west-1:

curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Missing account_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 '{"cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Missing cloudtrail_region 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 '{"account_id":"111111111111"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Unknown account_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 '{"account_id":"999999999999","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Extra unused body keys are ignored (iam_role_arn does not change the role):

curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1","iam_role_arn":"ignored"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

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 '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

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 '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Kubernetes AWS is a separate collection (/kubernetes-protection/entities/accounts/aws/v1): K8s AWS. Cloud GCP Connect is a separate collection (/cloud-connect-cspm-gcp/entities/account/v2): CSPM GCP. Kubernetes is a separate collection: Kubernetes. Hosts is a separate collection: Hosts. CSPM Azure is a separate collection: CSPM Azure.

DELETE ids=333333333333 returns empty resources. Success is 200. A later GET ids=333333333333 is empty. A second DELETE of the same id is 400. This is not Kubernetes AWS DELETE /kubernetes-protection/entities/accounts/aws/v1. Extra unused query keys (organization-ids, parameters) are ignored. Empty body:

curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'

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/cloud-connect-cspm-aws/entities/account/v1'

Unknown account id 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/cloud-connect-cspm-aws/entities/account/v1?ids=999999999999'

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/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'

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/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Kubernetes AWS is a separate collection (/kubernetes-protection/entities/accounts/aws/v1): K8s AWS. Cloud GCP Connect is a separate collection (/cloud-connect-cspm-gcp/entities/account/v2): CSPM GCP. Kubernetes is a separate collection: Kubernetes. Hosts is a separate collection: Hosts. CSPM Azure is a separate collection: CSPM Azure.

List (Bearer)​

TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

cspm-registration:read → 200. A token without that scope (including hosts:read only, e.g. cs-local-hosts) → 403. Missing or revoked token → 401. GetAwsAccount stays cspm-registration:read. There is no seeded production client with cspm-registration:read — use the console cookie, or a client you created with that scope.

Download scripts (Bearer)​

TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/user-scripts-download/v1'

cspm-registration:read → 200. A token without that scope (including hosts:read only, e.g. cs-local-hosts) → 403. Missing or revoked token → 401. GetAwsAccountScriptsAttachment stays cspm-registration:read. PEP 8 get_aws_account_scripts_attachment. There is no seeded production client with cspm-registration:read — use the console cookie, or a client you created with that scope.

Setup URLs (Bearer)​

TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/console-setup-urls/v1'

cspm-registration:read → 200. A token without that scope (including hosts:read only, e.g. cs-local-hosts) → 403. Missing or revoked token → 401. GetAwsConsoleSetupURLs stays cspm-registration:read. PEP 8 get_aws_console_setup_urls. There is no seeded production client with cspm-registration:read — use the console cookie, or a client you created with that scope.

Create (Bearer)​

TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"account_id":"333333333333","cloudtrail_region":"us-west-2"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

cspm-registration:write → 200 on POST. A token without that scope (including hosts:read only, e.g. cs-local-hosts, or cspm-registration:read) → 403. Missing or revoked token → 401. There is no product-seeded write client with cspm-registration:write — use the console cookie, or a client you created with that scope. CreateAwsAccount stays cspm-registration:write. PEP 8 create_aws_account.

Patch (Bearer)​

TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"account_id":"111111111111","cloudtrail_region":"us-west-1"}' \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1'

cspm-registration:write → 200 on PATCH. A token without that scope (including hosts:read only, e.g. cs-local-hosts, or cspm-registration:read) → 403. Missing or revoked token → 401. There is no product-seeded write client with cspm-registration:write — use the console cookie, or a client you created with that scope. PatchAwsAccount stays cspm-registration:write. SOURCE PatchCSPMAwsAccount. PEP 8 update_aws_account. Distinct from Kubernetes AWS update and CreateAwsAccount.

Delete (Bearer)​

TOKEN='<access_token from a client with cspm-registration:write>'
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/cloud-connect-cspm-aws/entities/account/v1?ids=333333333333'

cspm-registration:write → 200 on DELETE. A token without that scope (including hosts:read only, e.g. cs-local-hosts, or cspm-registration:read) → 403. Missing or revoked token → 401. There is no product-seeded write client with cspm-registration:write — use the console cookie, or a client you created with that scope. DeleteAwsAccount stays cspm-registration:write. PEP 8 delete_aws_account.

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