GET /api/project/v1/list/

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
      }
    ]
  }
}

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
      }
    ]
  }
}

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

string

required

Signed JWT returned by /api/user/v1/login/ or /api/user/v1/create/.

Response

integer

required

1 on success, 0 on failure.

string

required

projects_listed on success.

object

Show properties

object[]

Array of project objects the user belongs to.

Show project properties

string

UUID of the project.

string

Project name.

string

Project description.

string

Project domain URL, or empty string.

string

ISO 8601 timestamp of project creation.

string

ISO 8601 timestamp of last project update.

boolean

Whether the project is currently active.

string

UUID of the user who created the project.

integer

The authenticated user’s role in this project. 1 = Admin, 2 = Member.

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_description`	HTTP status	Cause
`missing_token`	400	The `X-OTAS-USER-TOKEN` header was absent.
`invalid_token`	401	The token is malformed, expired, or not associated with a user.
`projects_list_failed`	500	Unexpected server-side error.

UASAM — Users & Auth

UASAM — Projects & Keys

UASAM — Agents

Brain — Event Capture

Brain — Analytics

GET /api/project/v1/list/

Request

Headers

Response

Example

Error responses

​Request

​Headers

​Response

​Example

​Error responses

Request

Headers

Response

Example

Error responses