v29

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-233765161.7 KB
v1 projects

Get projects

Get projects accessible to the caller.

This endpoint:
- **No user_id param** (or user_id == root user): root user → returns **all** projects across the org
- **user_id param** (sub-user): returns only that sub-user's projects
- Includes project metadata (name, description, creation date)

**Authentication**: Requires valid API key or JWT token
get/v1/projects

Query parameters

user_idstring nullable

Response

Successful Response

total_countinteger required

Total number of projects

user_idstring nullable

User ID (set when filtering by user)

org_idstring nullable

Organization ID (set when returning org-wide projects)

Example response

{
  "projects": [
    {
      "created_at": "2023-01-01T00:00:00Z",
      "description": "A project for organizing research notes",
      "name": "My Research Project",
      "project_id": "123e4567-e89b-12d3-a456-426614174000",
      "updated_at": "2023-01-15T00:00:00Z",
      "user_email": "john@example.com",
      "user_id": "456e7890-e89b-12d3-a456-426614174001",
      "user_name": "John Doe"
    }
  ],
  "total_count": 1,
  "user_id": "456e7890-e89b-12d3-a456-426614174001"
}