---
title: Projects API
---

## List Projects

```
GET /v1/projects
```

**Response:**
```json
[
  {
    "id": "uuid",
    "teamId": "uuid",
    "name": "My SaaS",
    "slug": "my-saas",
    "description": "Main application",
    "createdAt": "2026-03-28T00:00:00Z"
  }
]
```

## Create Project

```
POST /v1/projects
```

```json
{
  "name": "My New Project"
}
```

## Get Project

```
GET /v1/projects/:projectId
```

## Update Project

```
PATCH /v1/projects/:projectId
```

```json
{
  "name": "Updated Name"
}
```

## Delete Project

```
DELETE /v1/projects/:projectId
```

> **Warning:**
>
> Deleting a project deletes all environments and services within it.

## List Environments

```
GET /v1/projects/:projectId/environments
```

## Create Environment

```
POST /v1/projects/:projectId/environments
```

```json
{
  "name": "staging",
  "type": "staging"
}
```