Projects API

GET /v1/projects

curl https://api.nextoriahub.com/v1/projects?status=in_progress&limit=10 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "proj_abc123",
      "name": "Acme Corp Brand Refresh",
      "status": "in_progress",
      "start_date": "2026-02-01",
      "end_date": "2026-04-30",
      "budget": 15000,
      "budget_spent": 6200,
      "client": {
        "id": "client_xyz789",
        "name": "Acme Corp"
      },
      "team_lead": {
        "id": "user_abc456",
        "name": "Alice Smith"
      },
      "task_count": 42,
      "completed_task_count": 18,
      "created_at": "2026-01-28T10:00:00Z",
      "updated_at": "2026-02-15T14:32:00Z"
    }
  ],
  "meta": {
    "total": 87,
    "limit": 10,
    "next_cursor": "cur_def456"
  }
}

POST /v1/projects

{
  "name": "Globex Website Redesign",
  "description": "Full redesign of the marketing site and blog.",
  "client_id": "client_globex123",
  "team_lead_id": "user_bob789",
  "start_date": "2026-03-01",
  "end_date": "2026-05-31",
  "budget": 22000,
  "status": "planning"
}

PATCH /v1/projects/:id

{
  "status": "in_progress",
  "end_date": "2026-06-15"
}

DELETE /v1/projects/:id

interface Project {
  id: string; // "proj_abc123"
  name: string;
  description: string | null;
  status: "planning" | "in_progress" | "review" | "completed" | "archived";
  start_date: string | null; // ISO 8601 date
  end_date: string | null;
  budget: number | null; // In workspace currency (minor units)
  budget_spent: number;
  client: { id: string; name: string } | null;
  team_lead: { id: string; name: string } | null;
  task_count: number;
  completed_task_count: number;
  created_at: string; // ISO 8601 datetime
  updated_at: string;
}