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

# Projects API

> Create, list, update, and delete Ardent projects

Projects organize related connectors and branches inside an organization. Most teams create one project per application or environment family.

## Endpoints

| Method   | Path                                                | Description                        |
| -------- | --------------------------------------------------- | ---------------------------------- |
| `POST`   | [`/v1/projects`](/api/projects/create)              | Create a project                   |
| `GET`    | [`/v1/projects`](/api/projects/list)                | List projects visible to the token |
| `GET`    | [`/v1/projects/{project_id}`](/api/projects/get)    | Get one project                    |
| `PATCH`  | [`/v1/projects/{project_id}`](/api/projects/update) | Rename a project                   |
| `DELETE` | [`/v1/projects/{project_id}`](/api/projects/delete) | Delete a project                   |

<Warning>
  Deleting a project takes everything under it with it. For routine cleanup, delete branches or unused connectors instead.
</Warning>