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

# Projects

> Create and manage project workspaces

Projects are workspaces that group MCP servers, API keys, and billing together.

**Required scope:** `servers:read` (read operations), `servers:write` (mutations)

***

## List projects

```
GET /v1/projects
```

Returns all projects belonging to the authenticated user.

**Query parameters:** Standard [pagination](/api-reference/overview#pagination) (`limit`, `cursor`)

**Response `200`:**

```json theme={null}
{
  "data": [
    {
      "id": "proj_abc123",
      "name": "My Project",
      "slug": "my-project",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "meta": {
    "cursor": null,
    "hasMore": false,
    "total": 1
  }
}
```

***

## Create project

```
POST /v1/projects
```

**Request body:**

```json theme={null}
{
  "name": "My Project"
}
```

**Response `201`:**

```json theme={null}
{
  "data": {
    "id": "proj_abc123",
    "name": "My Project",
    "slug": "my-project",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  }
}
```

***

## Get project

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

**Response `200`:** Single project object (same shape as list item).

***

## Update project

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

**Request body:**

```json theme={null}
{
  "name": "New Name"
}
```

**Response `200`:** Updated project object.

***

## Delete project

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

Deletes the project and all its servers, deployments, and API keys. This action is irreversible.

**Response `204`:** No content.