Skip to main content
This endpoint returns every active project the authenticated user is a member of, ordered by most recently created. Each entry includes the project’s metadata and the user’s privilege level within that project (1 = Admin, 2 = Member). Only projects where both the project and the membership are marked active are included.

​
Request

Method: GET
URL: http://localhost:8000/api/project/v1/list/
Authentication: X-OTAS-USER-TOKEN header

​
Headers

​
X-OTAS-USER-TOKEN
string
required
Signed JWT returned by /api/user/v1/login/ or /api/user/v1/create/.

​
Response

​
status
integer
required
1 on success, 0 on failure.
​
status_description
string
required
projects_listed on success.
​
response_body
object

​
Example

curl --request GET \
  --url http://localhost:8000/api/project/v1/list/ \
  --header 'X-OTAS-USER-TOKEN: <your-token>'

{
  "status": 1,
  "status_description": "projects_listed",
  "response_body": {
    "projects": [
      {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "My Agent App",
        "description": "Production project for the recommendation agent",
        "domain": "https://myapp.example.com",
        "created_at": "2026-04-16T10:00:00.000000",
        "updated_at": "2026-04-16T10:00:00.000000",
        "is_active": true,
        "created_by": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "privilege": 1
      }
    ]
  }
}

​
Error responses

status_descriptionHTTP statusCause
missing_token400The X-OTAS-USER-TOKEN header was absent.
invalid_token401The token is malformed, expired, or not associated with a user.
projects_list_failed500Unexpected server-side error.

Build docs developers (and LLMs) love

Get started for freeTalk to us