cxas delete¶

cxas delete permanently removes an app from CX Agent Studio — use it to clean up temporary CI apps, old branches, or anything you no longer need.

Deletion is permanent

There is no undo. Make sure you've pulled a copy first if you might want the content later.

Usage¶

cxas delete [--app-name APP] [--display-name NAME]
            [--project-id PROJECT] [--location LOCATION]
            [--force]

Option	Required	Default	Description
`--app-name APP`	No*	—	Full resource name of the app to delete (e.g., `projects/{project}/locations/{location}/apps/{app}`). Required if `--display-name` is not provided.
`--display-name NAME`	No*	—	Display name of the app to delete. The CLI looks it up and resolves the resource name automatically. Required if `--app-name` is not provided.
`--project-id PROJECT`	No*	—	GCP project ID. Required when using `--display-name`.
`--location LOCATION`	No*	—	GCP location. Required when using `--display-name`.
`--force`	No	`false`	Force deletion even if the app still has child resources (e.g., evaluations, agents). Without this flag the platform may reject the request if the app is not empty.

*You must provide either --app-name OR (--display-name + --project-id + --location).

Delete by display name:

cxas delete \
  --display-name "My Support Agent" \
  --project-id my-gcp-project \
  --location us-central1

Delete by full resource name:

cxas delete \
  --app-name projects/my-gcp-project/locations/us-central1/apps/abc123

Force-delete an app that still has resources inside it:

cxas delete \
  --app-name projects/my-gcp-project/locations/us-central1/apps/abc123 \
  --force

Clean up a temporary CI app by its deterministic display name:

cxas delete \
  --display-name "[CI] PR-123 Test Agent" \
  --project-id my-gcp-project \
  --location us-central1

cxas apps — List apps to find the one you want to delete.
cxas create — Create a new app.
cxas ci-test — The CI test lifecycle automatically manages temporary app creation and cleanup.