Skip to main content
GET
/
ai
/
chats
/
list
List chats
curl --request GET \
  --url https://api.getcargo.io/v1/ai/chats/list \
  --header 'Authorization: Bearer <token>'
{
  "chats": [
    {
      "uuid": "<string>",
      "slug": "<string>",
      "workspaceUuid": "<string>",
      "userUuid": "<string>",
      "agentUuid": "<string>",
      "releaseUuid": "<string>",
      "name": "<string>",
      "trigger": "<unknown>",
      "activeStreamUuid": "<string>",
      "creditsUsedCount": 123,
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "deletedAt": "<string>",
      "lastMessage": {
        "uuid": "<string>",
        "workspaceUuid": "<string>",
        "agentUuid": "<string>",
        "releaseUuid": "<string>",
        "chatUuid": "<string>",
        "userUuid": "<string>",
        "status": "pending",
        "errorMessage": "<string>",
        "type": "user",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "finishedAt": "<string>",
        "deletedAt": "<string>"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
agentUuid
string

Filter chats by agent identifier.

​
releaseUuid
string

Filter chats by release identifier.

​
userUuid
string

Filter chats by user identifier.

​
triggerType
enum<string>

Filter chats by trigger type.

Available options:
connector,
draft,
web_extension,
app,
workflow
​
limit
string

Maximum number of chats to return.

​
offset
string

Number of chats to skip.

Response

Successful response

​
chats
Chats · object[]
required

List of chats.