Skip to content

cxas apps

cxas apps gives you quick visibility into what's deployed in your project — use list to see all your apps at a glance, or get to dig into the details of a specific one.

Usage

cxas apps list --project-id PROJECT --location LOCATION

cxas apps get <app> [--project-id PROJECT] [--location LOCATION]

cxas apps list

Lists every app in the given project and location, formatted as a table showing display names and resource names.

Options

Option Required Default Description
--project-id PROJECT Yes — GCP project ID to list apps from.
--location LOCATION Yes — GCP location (e.g., global, us-central1).

Example

cxas apps list \
  --project-id my-gcp-project \
  --location us-central1

Output:

Apps:
 Display Name                     Name
 My Support Agent                 projects/my-gcp-project/locations/us-central1/apps/abc123
 Billing Assistant                projects/my-gcp-project/locations/us-central1/apps/def456
 [CI] PR-42 Test Agent            projects/my-gcp-project/locations/us-central1/apps/ghi789

cxas apps get

Retrieves and prints the full details of a single app, including its resource name, display name, description, and timestamps.

Arguments

Argument Required Description
app Yes Full resource name or display name of the app to look up.

Options

Option Required Default Description
--project-id PROJECT No* — GCP project ID. Required when app is a display name.
--location LOCATION No* — GCP location. Required when app is a display name.

*Required when app is specified as a display name.

Examples

Get by display name:

cxas apps get "My Support Agent" \
  --project-id my-gcp-project \
  --location us-central1

Get by full resource name:

cxas apps get projects/my-gcp-project/locations/us-central1/apps/abc123

Output:

App Details:
Name:         projects/my-gcp-project/locations/us-central1/apps/abc123
Display Name: My Support Agent
Description:  Handles customer support queries.
Create Time:  2026-01-15T10:30:00Z
Update Time:  2026-04-01T08:45:00Z