Join Community
DocsDeveloper GuideAPI DocumentationChangelog
Projects

List Projects

Get all chatbot projects your token can access.

Returns all projects your token has access to. Use this to get project_uid values needed for other endpoints.

  • scope_type: all — all projects in the organization
  • scope_type: selected — only projects assigned to this token

Any valid token can call this endpoint.

POST
/getMyProjects

Authorization

bearerToken

AuthorizationBearer <token>

API token for YourGPT Public APIs. Create tokens in Settings > API Tokens in your YourGPT dashboard.

In: header

Request Body

application/json

search?string

Filter projects by name (partial match).

limit?integer

Number of projects to return per page.

Default100
page?integer

Page number for pagination. Default 1.

Default1
orderBy?string

Sort order by project ID. Default ASC.

Default"ASC"
Value in"ASC" | "DESC"

Response Body

application/json

application/json

application/json

curl -X POST "https://api.yourgpt.ai/chatbot/v1/getMyProjects" \  -H "Content-Type: application/json" \  -d '{}'
{
  "type": "RXSUCCESS",
  "message": "Data Fetched Successfully!",
  "total": 3,
  "data": [
    {
      "id": 12345,
      "organization_id": 100,
      "name": "My Support Bot",
      "app_id": 1,
      "project_uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "purpose": "Chatbot",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-06-20T14:45:00.000Z",
      "organization": {
        "id": 100,
        "name": "My Organization",
        "role": "owner"
      },
      "ProjectMembers": [
        {
          "user_id": 42,
          "role": "owner"
        }
      ],
      "integration_setting": {
        "id": 100,
        "project_id": 12345,
        "widget_uid": "w1x2y3z4-a5b6-7890-cdef-1234567890ab"
      }
    }
  ]
}
{
  "type": "RXERROR",
  "message": "Invalid or revoked API token"
}
{
  "type": "RXERROR",
  "message": "API token is inactive. Token creator is no longer a member of the organization."
}