Projects

List projects

GET /api/v1/projects

Any role. Returns the projects the key's owner can see, newest first. Confidential projects are included only for owners, admins, and members of that project. shareToken (the secret in the project's client link, or null) is only included for owner and admin keys.

curl "https://<your-instance>/api/v1/projects?clientId=cm9..." \
  -H "Authorization: Bearer ch_live_..."

{
  "projects": [
    {
      "id": "cm9...",
      "name": "API migration",
      "status": "ACTIVE",
      "billingType": "HOURLY",
      "budgetHours": "120",
      "confidential": false,
      "clientId": "cm9...",
      "client": { "id": "cm9...", "name": "Fintra Labs" },
      "...": "..."
    }
  ]
}

status is ACTIVE, ON_HOLD, COMPLETED or ARCHIVED. billingType is HOURLY, FLAT_FEE or MILESTONE.

To create or change projects, use the app or the MCP server's create_project and update_project tools. For a project's tasks, see Tasks.