SaaS SDKSaaS APIprojects

List projects

View as Markdown

List projects for an Enterprise workspace. Supports pagination, search, sorting, and analytics period filters; when Collector analytics is configured, cost, requests, and tokens are merged from project assignments. All workspace members may read; PATs require the read scope.

Headers

AuthorizationstringRequired

Bearer {access_token}

X-Workspace-IdstringRequiredformat: "uuid"
Workspace UUID

Query parameters

pageintegerOptional>=0Defaults to 1

Page number; 0 or omitted uses default 1

pageSizeintegerOptional0-100Defaults to 12

Items per page; 0 or omitted uses default 12

searchstringOptional
Search by project name or description
sortByenumOptionalDefaults to updatedAt
Sort field
Allowed values:
sortDirenumOptionalDefaults to desc
Sort direction
Allowed values:
periodenumOptionalDefaults to 7d
Analytics period
Allowed values:

Response

data: list, meta: pagination and overview

datalist of objectsOptional
metaobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error