Projects

List projects

Browse projects in a workspace with cursor-based pagination.

get/projectsv1

Authorization

Authentication is required. bearerAuth
Enter credentials in the playground. Reuse is optional and stays in memory.
Authorizationstringheaderrequired

Bearer authentication header. Use Bearer <token>, where <token> is your access token.

Query parameters

limitinteger

Maximum number of projects to return.

integer
minimum
1
maximum
100
default
20
cursorstring

Continue from an earlier page.

string

Response

Projects retrieved successfully.

application/json
object
dataarray
Show child attributes
Array items Project
object
idstringrequired
namestringrequired
descriptionstring
statusstringrequired
Allowed values: "draft""active""archived"
created_atstring · date-timerequired
metadataobject
Show child attributes
Additional properties string
string
has_moreboolean
next_cursorstring | null
Example response
Example response
{
  "data": [
    {
      "id": "proj_aurora",
      "name": "Aurora",
      "description": "Customer-facing analytics",
      "status": "active",
      "created_at": "2026-01-15T10:30:00Z",
      "metadata": {
        "region": "eu-west",
        "environment": "production"
      }
    },
    {
      "id": "proj_horizon",
      "name": "Horizon",
      "description": "The next big thing",
      "status": "draft",
      "created_at": "2026-02-01T09:00:00Z",
      "metadata": {
        "region": "us-east",
        "environment": "development"
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}
Source: openapi.yaml#/paths/~1projects/get
Built with doctopus

What would you like to build?

Search guides, endpoints, and parameters.