List projects in the caller's location.

GET 
/ai-builder-api/projects

Lists the ClientPortal apps in the sub-account, most recently active first. A sub-account token sees every app by default; view=mine limits the list to apps the caller created.

Request

Version stringrequired

The API version.

Available optionsv3

view string

Ownership scope within the authenticated caller's location. mine returns only projects owned by the caller and requires projects:read; all returns every project in the location and requires projects:read_all. The location is always taken from the authenticated session and cannot be overridden.

Available optionsmineall

status ProjectStatus

Exact project-status filter. When omitted, all statuses except deleted are returned. Results remain scoped by view and the authenticated caller's location.

Available optionsdraftqueuedplanningbuildingpreviewingdeployingdeployedblockedarchiveddeleted

limit integer

How many projects per page (default 50).

Possible values: >= 1 and <= 100

Default value:50

cursor string

meta.nextCursor from the previous page.

application/json

Project page.

application/json

Schema

Schema

dataobject[]required

The projects on this page.

metaobjectrequired

Paging: send meta.nextCursor as cursor for the next page.

Example (auto)

{
  "data": [],
  "meta": {
    "nextCursor": "eyJpZCI6InByal8xMjMifQ",
    "limit": 50,
    "hasMore": true,
    "total": 42
  }
}