Projects API

Create and manage development projects. The Projects API supports a full lifecycle from creation through interactive intake to estimation.

GET/projectsprojects:read

List all projects for the authenticated user.

Response

{
  "success": true,
  "data": [
    {
      "id": "proj_abc123",
      "name": "My App",
      "status": "in_progress",
      "phase": "development",
      "progress": 45,
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}

GET/projects/:idprojects:read

Get detailed information about a specific project, including agents, budget, and phase breakdown.

Parameters

id (path, required) — Project ID

Response

{
  "success": true,
  "data": {
    "id": "proj_abc123",
    "name": "My App",
    "status": "in_progress",
    "phase": "development",
    "progress": 45,
    "budget": { "total": 5000, "spent": 2250, "remaining": 2750 },
    "agents": [
      { "id": "agent_1", "role": "lead_developer", "status": "active" }
    ],
    "phases": [ ... ],
    "created_at": "2025-01-15T10:00:00Z"
  }
}

POST/projectsprojects:write

Create a new project. This initializes a draft project and starts the interactive intake flow.

Request Body

{
  "name": "My New App",
  "description": "A React dashboard for analytics"
}

Response

{
  "success": true,
  "data": {
    "id": "proj_xyz789",
    "name": "My New App",
    "status": "draft",
    "source": "mcp",
    "next_step": "intake",
    "message": "Project created. Use the intake endpoints to answer questions."
  }
}

Interactive Intake

After creating a project, use the intake endpoints to answer questions about your project. The system asks up to 3 rounds of contextual questions, then generates an estimate.

GET/projects/:id/intakeprojects:read

Get the current round of intake questions for a draft project.

Response

{
  "success": true,
  "data": {
    "status": "questions",
    "round": 1,
    "questions": [
      {
        "id": "q_scope",
        "question": "What type of application are you building?",
        "type": "text",
        "required": true
      },
      {
        "id": "q_features",
        "question": "What are the core features?",
        "type": "text",
        "required": true
      }
    ]
  }
}

POST/projects/:id/intakeprojects:write

Submit answers for the current intake round. May return more questions or indicate readiness for submission.

Request Body

{
  "answers": [
    { "question_id": "q_scope", "answer": "SaaS web application" },
    { "question_id": "q_features", "answer": "Auth, dashboard, billing" }
  ]
}

POST/projects/:id/submitprojects:write

Submit the completed intake and request an estimate. Moves the project from draft to estimation.

Response

{
  "success": true,
  "data": {
    "status": "submitted",
    "message": "Brief submitted. Estimate will be ready shortly.",
    "estimated_ready_at": "2025-01-15T10:05:00Z"
  }
}

GET/projects/:id/estimateprojects:read

Get the cost and timeline estimate for a submitted project.

Response

{
  "success": true,
  "data": {
    "status": "ready",
    "estimate": {
      "cost_range": { "low": 3000, "high": 5000 },
      "timeline_days": { "low": 14, "high": 21 },
      "phases": [
        { "name": "Setup & Architecture", "days": 3 },
        { "name": "Core Development", "days": 10 },
        { "name": "Testing & QA", "days": 5 },
        { "name": "Deployment", "days": 3 }
      ]
    }
  }
}