Skip to main content
The ax spaces commands are currently in BETA. The API may change without notice. A one-time warning is emitted on first use.
The ax spaces commands let you create, retrieve, and manage spaces on the Arize platform.

ax spaces list

List all spaces, optionally filtered by organization.
ax spaces list [--organization-id <id>] [--limit <n>] [--cursor <cursor>]
OptionDescription
--organization-idFilter spaces by organization ID
--limitMaximum number of results to return (default: 15)
--cursorPagination cursor for the next page
Examples:
ax spaces list
ax spaces list --organization-id org_abc123
ax spaces list --output spaces.json

ax spaces create

Create a new space within an organization.
ax spaces create --name <name> --organization-id <id> [--description <text>]
OptionDescription
--nameName for the new space
--organization-idOrganization ID to create the space in
--descriptionOptional description for the space
Example:
ax spaces create --name "production" --organization-id org_abc123
ax spaces create --name "staging" --organization-id org_abc123 --description "Staging environment"

ax spaces get

Retrieve a single space by name or ID.
ax spaces get <name-or-id>
Example:
ax spaces get sp_abc123
ax spaces get "production"

ax spaces update

Update a space’s name or description. At least one of --name or --description must be provided.
ax spaces update <name-or-id> [--name <name>] [--description <text>]
OptionDescription
--nameNew name for the space
--descriptionNew description for the space
Examples:
ax spaces update sp_abc123 --name "production-v2"
ax spaces update sp_abc123 --description "Main production environment"
ax spaces update sp_abc123 --name "prod" --description "Production"

ax spaces delete

Delete a space and all resources within it. This operation is irreversible.
ax spaces delete <name-or-id> [--force]
OptionDescription
--forceSkip the confirmation prompt
Deleting a space permanently removes all resources that belong to it — models, monitors, dashboards, datasets, custom metrics, and experiments. Without --force, you will be prompted to type the space name or ID to confirm.
Examples:
ax spaces delete sp_abc123 --force
ax spaces delete "production"