Skip to main content
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 get

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

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 update

Update a space’s name or description. At least one of --name or --description must be provided.
ax spaces update <space-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"