POST/projects/list

List projects

Interactive-session operation. API keys are not accepted.

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL

Request body

application/json

org_idoptional

sortenumoptional

Values: "created-asc" · "created-desc" · "updated-asc" · "updated-desc"

paginationoptional

after_id and after_value must be supplied together.

filtersobjectoptional

Responses

200application/json

Project page.

{
  "status": "success",
  "data": {
    "projects": [
      {
        "id": "65f0c7a9a7d6b4e2c1234567",
        "name": "string",
        "abbr": "string",
        "org_id": "65f0c7a9a7d6b4e2c1234567",
        "org_name": "string",
        "description": "string",
        "environment": "development",
        "status": "active",
        "role": "string",
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-01T00:00:00Z"
      }
    ]
  },
  "pagination": {
    "limit": 1,
    "has_more": true,
    "next_cursor": {
      "after_id": "65f0c7a9a7d6b4e2c1234567",
      "after_value": "2026-01-01T00:00:00Z"
    },
    "filter_scan_truncated": true
  }
}

400application/json

The request body, parameter, filter, cursor, or project-scoping pattern is invalid.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}

statusstringrequired

messagestringrequired

codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional

quotaoptional

featurestringoptional

dependencystringoptional

401application/json

Authentication is missing or the credential is invalid, inactive, expired, or lacks the required scope.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}

statusstringrequired

messagestringrequired

codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional

quotaoptional

featurestringoptional

dependencystringoptional

curl --request POST \ '/v1/projects/list' \ --header 'Content-Type: application/json' \ --data '{ "org_id": "65f0c7a9a7d6b4e2c1234567", "sort": "created-desc", "pagination": { "limit": 25, "after_id": "65f0c7a9a7d6b4e2c1234567", "after_value": "2026-01-01T00:00:00Z" }, "filters": {}}'

{ "status": "success", "data": { "projects": [ { "id": "65f0c7a9a7d6b4e2c1234567", "name": "string", "abbr": "string", "org_id": "65f0c7a9a7d6b4e2c1234567", "org_name": "string", "description": "string", "environment": "development", "status": "active", "role": "string", "created_at": "2026-01-01T00:00:00Z", "updated_at": "2026-01-01T00:00:00Z" } ] }, "pagination": { "limit": 1, "has_more": true, "next_cursor": { "after_id": "65f0c7a9a7d6b4e2c1234567", "after_value": "2026-01-01T00:00:00Z" }, "filter_scan_truncated": true }}