> ## Documentation Index
> Fetch the complete documentation index at: https://arize-ax.mintlify.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects

> Manage projects with the AX CLI

<Note>
  The `ax projects` commands are currently in **BETA**. The API may change without notice. A one-time warning is emitted on first use.
</Note>

The `ax projects` commands let you create, retrieve, and manage projects on the Arize platform.

## `ax projects list`

List all projects in a space.

```bash theme={null}
ax projects list [--space <id>] [--name <filter>] [--limit <n>] [--cursor <cursor>]
```

| Option     | Description                                       |
| ---------- | ------------------------------------------------- |
| `--space`  | Filter by space name or ID                        |
| `--name`   | Case-insensitive substring filter on project name |
| `--limit`  | Maximum number of results to return (default: 15) |
| `--cursor` | Pagination cursor for the next page               |

**Example:**

```bash theme={null}
ax projects list --space sp_abc123
```

## `ax projects create`

Create a new project.

```bash theme={null}
ax projects create --name <name> --space <id>
```

| Option    | Description                               |
| --------- | ----------------------------------------- |
| `--name`  | Name for the new project                  |
| `--space` | Space name or ID to create the project in |

**Example:**

```bash theme={null}
ax projects create --name "my-project" --space sp_abc123
```

## `ax projects get`

Retrieve a project by name or ID.

```bash theme={null}
ax projects get <name-or-id> [--space <id>]
```

| Option    | Description                                                         |
| --------- | ------------------------------------------------------------------- |
| `--space` | Space name or ID (required when using a project name instead of ID) |

**Examples:**

```bash theme={null}
ax projects get proj_abc123
ax projects get my-project --space my-space
```

## `ax projects update`

Rename a project.

```bash theme={null}
ax projects update <name-or-id> --name <new-name> [--space <id>]
```

| Option          | Description                                                         |
| --------------- | ------------------------------------------------------------------- |
| `--name`, `-n`  | New name for the project                                            |
| `--space`, `-s` | Space name or ID (required when using a project name instead of ID) |

**Examples:**

```bash theme={null}
ax projects update proj_abc123 --name "renamed-project"
ax projects update my-project --space my-space --name "renamed-project"
```

## `ax projects delete`

Delete a project.

```bash theme={null}
ax projects delete <name-or-id> [--space <id>] [--force]
```

| Option    | Description                                                         |
| --------- | ------------------------------------------------------------------- |
| `--space` | Space name or ID (required when using a project name instead of ID) |
| `--force` | Skip the confirmation prompt                                        |

**Examples:**

```bash theme={null}
ax projects delete proj_abc123
ax projects delete my-project --space my-space --force
```