The ax spaces commands are currently in BETA. The API may change without notice. A one-time warning is emitted on first use. The add-user and remove-user commands are in ALPHA.
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>]
| Option | Description |
|---|
--organization-id | Filter spaces by organization ID |
--limit, -l | Maximum number of results to return (default: 15) |
--cursor, -c | Pagination cursor for the next page |
--output, -o | Output format (table, json, csv, parquet) or file path |
--verbose, -v | Enable verbose logs |
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>]
| Option | Description |
|---|
--name, -n | Name for the new space (prompted if omitted) |
--organization-id | Organization ID to create the space in (prompted if omitted) |
--description | Optional description for the space |
--output, -o | Output format (table, json, csv, parquet) or file path |
--verbose, -v | Enable verbose logs |
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>
| Option | Description |
|---|
--output, -o | Output format (table, json, csv, parquet) or file path |
--verbose, -v | Enable verbose logs |
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>]
| Option | Description |
|---|
--name, -n | New name for the space |
--description | New description for the space |
--output, -o | Output format (table, json, csv, parquet) or file path |
--verbose, -v | Enable verbose logs |
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]
| Option | Description |
|---|
--force, -f | Skip the confirmation prompt |
--verbose, -v | Enable verbose logs |
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.
ax spaces delete sp_abc123 --force
ax spaces delete "production"
ax spaces add-user
Add a user to a space, or update their role if already a member (upsert semantics). The user must already be a member of the space’s parent organization.
ax spaces add-user <name-or-id> --user-id <id> --role <role>
| Option | Description |
|---|
--user-id | Global ID of the user to add (prompted if omitted) |
--role, -r | Predefined space role: admin, member, read-only, or annotator (prompted if omitted) |
--output, -o | Output format (table, json, csv, parquet) or file path |
--verbose, -v | Enable verbose logs |
ax spaces add-user sp_abc123 --user-id usr_xyz789 --role member
ax spaces remove-user
Remove a user from a space.
ax spaces remove-user <name-or-id> --user-id <id> [--force]
| Option | Description |
|---|
--user-id | Global ID of the user to remove (prompted if omitted) |
--force, -f | Skip the confirmation prompt |
--verbose, -v | Enable verbose logs |
ax spaces remove-user sp_abc123 --user-id usr_xyz789
ax spaces remove-user sp_abc123 --user-id usr_xyz789 --force
