List AI projects

GET 
/ai/projects

Returns the AI projects you can access. Super-admins see every project and are treated as owners. Pinned projects are returned separately in pinnedProjects, in the order user pinned them, and are not included in projects. Each response also includes recentThreads, a combined list of recent threads across those projects. Pass type=categories to list categories instead of projects. That response returns only Categories — each category name and how many projects use it — and ignores paging, sorting, filtering, and field projection. Projects with no category are not included.

Request

Responses

200

Project list, or category list when type=categories. Page through projects by increasing offset by limit while next_available is the string "yes". Stop when it is "no". next_available is a string, not a boolean. total_count is the number of matching unpinned projects; count is how many are on this page. pinnedProjects and recentThreads are returned in full on every page.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

400

The request was invalid or you do not have permission. The body is {"Message": " - "}. Common cases include a missing role_id (AUTH-1001), missing ai.view permission (AUTH-1030), a limit above 1000 (IPV-1045), or a malformed filterExpression (IPV-1004). Permission failures return 400, not 403.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

500

An unexpected server error. The body is typically {"Message": "GE-1008 - Could not complete the request. Please try again."}. This can also occur if sortby names a missing or non-string field.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security