> ## 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 Arize projects programmatically. Create, list, retrieve, and delete projects within your spaces using the Python SDK.

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

Manage projects programmatically. Create, list, retrieve, and delete projects within your Arize spaces.

## Key Capabilities

* Create and manage projects within spaces
* List projects with pagination support
* Retrieve project details by name or ID
* Delete projects when no longer needed

## List Projects

List all projects you have access to, with optional filtering by space.

```python theme={null}
resp = client.projects.list(
    space="your-space-name-or-id",  # optional
    name="fraud",                   # optional substring filter
    limit=50,
)

for project in resp.projects:
    print(project.id, project.name)
```

For details on pagination, field introspection, and data conversion (to dict/JSON/DataFrame), see [Response Objects](/api-clients/python/version-8/overview#response-objects).

## Create a Project

Create a new project within a space. Project names must be unique within the target space.

```python theme={null}
project = client.projects.create(
    name="fraud-detection-app",
    space="your-space-name-or-id",
)

print(project)
```

## Get a Project

Retrieve a specific project by name or ID. When using a name, provide `space` to disambiguate.

```python theme={null}
project = client.projects.get(
    project="project-name-or-id",
    space="your-space-name-or-id",  # required when using a name
)

print(project)
```

## Delete a Project

Delete a project by name or ID. This operation is irreversible. There is no response from this call.

```python theme={null}
client.projects.delete(
    project="project-name-or-id",
    space="your-space-name-or-id",  # required when using a name
)

print("Project deleted successfully")
```

## Rename a Project

<Note>
  The `update` method is currently in **ALPHA**. The API may change without notice.
</Note>

Rename a project. The new name must be unique within the space.

```python theme={null}
project = client.projects.update(
    project="project-name-or-id",
    space="your-space-name-or-id",  # required when using a name
    name="renamed-project",
)

print(project.name)
```