List Projects (Paginated)

GET

/v1/projects/list

curl --request GET \
  --url 'https://example.com/v1/projects/list?limit=20&sort=newest'

List projects for the current user with cursor-based pagination.

Parameters

Query Parameters

search

Any of:

string

string

<= 200 characters

null

null

Search project name

limit

Limit

integer

default: 20 >= 1 <= 1000

cursor

Any of:

string

string

null

null

Pagination cursor

sort

Sort

string

default: newest

Allowed values: newest oldest updated name

Header Parameters

x-api-key

Any of:

string

string

null

null

Responses

200

Paginated list of projects

Media type application/json

PaginatedProjectsResponse

object

items

Items

Array<object>

ProjectItem

object

project_id

required

Project Id

string format: uuid

name

required

Name

string

description

Any of:

string

string

null

null

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

page_info

required

PageInfo

object

has_next

required

Has Next

Whether more items exist after this page

boolean

end_cursor

Any of:

string

string

null

null

total_count

Any of:

integer

integer

null

null

Example ^generated

{
  "items": [
    {
      "project_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "name": "example",
      "description": "example",
      "created_at": "2026-04-15T12:00:00Z",
      "updated_at": "2026-04-15T12:00:00Z"
    }
  ],
  "page_info": {
    "has_next": true,
    "end_cursor": "example",
    "total_count": 1
  }
}

401

Invalid or missing API key

Media type application/json

ErrorResponse

Standard error response.

object

detail

required

Detail

Error message describing what went wrong

string

Example ^generated

{
  "detail": "example"
}

422

Invalid pagination parameters