> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valkyrie.vals.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects resource

> Reference for client.projects.

Access these methods through `client.projects`.

## `client.projects.create`

Create a project that runs can be started in; the `handle` is unique within the organization.

```python Signature theme={null}
async def create(
    handle: str,
    *,
    name: str,
    spend_type: SpendType,
    subcategory: str,
    customer: str | None = None,
    extra_tags: Mapping[str, str] | None = None,
) -> ProjectResponse
```

**Parameters**

handlerequired · str

namerequired · str

spend\_typerequired · [`SpendType`](https://docs.valkyrie.vals.ai/reference/sdk/models/projects#spend-type)

subcategoryrequired · str

customeroptional · str | None · default: `None`

extra\_tagsoptional · Mapping\[str, str] | None · default: `None`

**Returns**

[`ProjectResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/projects#project-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.projects.list`

List the organization's projects by handle.

```python Signature theme={null}
async def list() -> ProjectsResponse
```

**Returns**

[`ProjectsResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/projects#projects-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.projects.update`

Replace a project's shared spend metadata without changing its handle.

```python Signature theme={null}
async def update(
    handle: str,
    *,
    name: str,
    spend_type: SpendType,
    subcategory: str,
    customer: str | None = None,
    extra_tags: Mapping[str, str] | None = None,
) -> ProjectResponse
```

**Parameters**

handlerequired · str

namerequired · str

spend\_typerequired · [`SpendType`](https://docs.valkyrie.vals.ai/reference/sdk/models/projects#spend-type)

subcategoryrequired · str

customeroptional · str | None · default: `None`

extra\_tagsoptional · Mapping\[str, str] | None · default: `None`

**Returns**

[`ProjectResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/projects#project-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.projects.delete`

Delete an unused project; Tracker rejects projects with run history.

```python Signature theme={null}
async def delete(handle: str) -> ProjectResponse
```

**Parameters**

handlerequired · str

**Returns**

[`ProjectResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/projects#project-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.