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

Search project name

string | null

<= 200 characters

Search project name

limit

integer

default: 20 >= 1 <= 1000

cursor

Pagination cursor

string | null

Pagination cursor

sort

string

default: newest

Allowed values: newest oldest updated name

Header Parameters

x-api-key

string | null

Responses

200

Paginated list of projects

Media type application/json

PaginatedProjectsResponse

object

items

Array<object>

ProjectItem

object

project_id

required

string format: uuid

name

required

string

description

string | null

created_at

required

string format: date-time

updated_at

required

string format: date-time

page_info

required

PageInfo

object

has_next

required

Whether more items exist after this page

boolean

end_cursor

Cursor for the next page

string | null

total_count

Total matching items

integer | 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

Error message describing what went wrong

string

Example ^generated

{
  "detail": "example"
}

422

Invalid pagination parameters