Projects API

List Projects

GET /api/v1/workspaces/{workspace_id}/projects
Authorization: Bearer <token>

Response 200 OK

[
  {
    "id": "uuid",
    "workspace_id": "uuid",
    "name": "My Project",
    "project_key": "my-project",
    "description": "...",
    "status": "active",
    "tech_stack": ["python", "fastapi"],
    "repo_url": "https://github.com/...",
    "default_branch": "main",
    "budget_total_limit_usd": 100.00,
    "budget_used_usd": 12.50,
    "created_at": "2026-01-01T00:00:00Z"
  }
]

Create Project

POST /api/v1/workspaces/{workspace_id}/projects
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "My Project",
  "project_key": "my-project",
  "description": "A web application",
  "tech_stack": ["python", "fastapi", "react"],
  "repo_url": "https://github.com/org/repo",
  "default_branch": "main",
  "budget_total_limit_usd": 100.00
}

Get Project

GET /api/v1/projects/{project_id}
Authorization: Bearer <token>

Update Project

PUT /api/v1/projects/{project_id}
Authorization: Bearer <token>
Content-Type: application/json

{
  "description": "Updated description",
  "tech_stack": ["python", "fastapi", "react", "postgresql"]
}