Skip to main content
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 (limit, cursor) Response 200:
{
  "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:
{
  "name": "My Project"
}
Response 201:
{
  "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:
{
  "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.