<!-- source: https://modelux.ai/docs/api/management-projects -->

> Create, list, and manage projects via the Management API.

# Projects API

Projects group API keys, routing configs, and usage analytics. Most accounts
use one project per app or environment.

## List projects

```
GET /manage/v1/projects
```

Returns all projects in the authenticated organization.

**Query parameters**

| Name | Type | Description |
|---|---|---|
| `cursor` | string | Opaque pagination cursor |
| `limit` | integer | Max items per page (default 50, max 200) |

**Response**

```json
{
  "data": [
    {
      "id": "proj_01HXY...",
      "name": "production",
      "slug": "production",
      "description": "main API traffic",
      "created_at": "2026-04-01T12:00:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
```

## Get a project

```
GET /manage/v1/projects/{project_id}
```

## Create a project

```
POST /manage/v1/projects
```

**Request body**

```json
{
  "name": "staging",
  "description": "optional — shown in the dashboard"
}
```

Returns the created project.

## Update a project

```
PATCH /manage/v1/projects/{project_id}
```

Supports partial updates of `name` and `description`.

## Delete a project

```
DELETE /manage/v1/projects/{project_id}
```

Soft-delete. Existing API keys scoped to this project are revoked.
Historical analytics remain queryable with `include_deleted=true`.

## MCP tools

| Tool | Maps to |
|---|---|
| `list_projects` | `GET /manage/v1/projects` |
| `get_project` | `GET /manage/v1/projects/{id}` |
| `create_project` | `POST /manage/v1/projects` |
| `update_project` | `PATCH /manage/v1/projects/{id}` |
| `delete_project` | `DELETE /manage/v1/projects/{id}` |

## See also

- [Projects & API Keys (concept)](/docs/concepts/projects)
- [Management API overview](/docs/api/management)