> ## 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 programmatically within your Arize AX spaces using the TypeScript SDK.

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

## List Projects

```typescript theme={null}
import { listProjects } from "@arizeai/ax-client";

const { data: projects, pagination } = await listProjects({
  space: "my-space",  // space name or ID (optional)
  name: "customer",   // substring filter on project name (optional)
  limit: 10,
});
```

## Create a Project

```typescript theme={null}
import { createProject } from "@arizeai/ax-client";

const project = await createProject({
  space: "my-space",  // space name or ID
  name: "your_project_name",
});
```

## Get a Project

```typescript theme={null}
import { getProject } from "@arizeai/ax-client";

// By ID
const project = await getProject({ project: "your_project_id" });

// By name (requires space)
const project = await getProject({ project: "my-project", space: "my-space" });
```

## Update a Project

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

```typescript theme={null}
import { updateProject } from "@arizeai/ax-client";

const project = await updateProject({
  project: "my-project",  // project name or ID
  space: "my-space",      // required when project is a name
  name: "my-renamed-project",
});
```

## Delete a Project

```typescript theme={null}
import { deleteProject } from "@arizeai/ax-client";

// By ID
await deleteProject({ project: "your_project_id" });

// By name (requires space)
await deleteProject({ project: "my-project", space: "my-space" });
```