Skip to main content
GET
/
ai
/
messages
/
list
List messages
curl --request GET \
  --url https://api.getcargo.io/v1/ai/messages/list \
  --header 'Authorization: Bearer <token>'
{
  "messages": [
    {
      "uuid": "<string>",
      "workspaceUuid": "<string>",
      "agentUuid": "<string>",
      "releaseUuid": "<string>",
      "chatUuid": "<string>",
      "userUuid": "<string>",
      "status": "pending",
      "errorMessage": "<string>",
      "type": "user",
      "parts": [
        "<unknown>"
      ],
      "tools": [
        {
          "name": "<string>",
          "slug": "<string>",
          "description": "<string>",
          "isBulkAllowed": true,
          "config": {},
          "kind": "<string>",
          "toolUuid": "<string>",
          "templateSlug": "<string>"
        }
      ],
      "resources": [
        {
          "kind": "<string>",
          "name": "<string>",
          "slug": "<string>",
          "description": "<string>",
          "integrationSlug": "<string>",
          "modelUuid": "<string>",
          "filter": {
            "conjonction": "or",
            "groups": [
              "<unknown>"
            ]
          },
          "selectedColumnSlugs": [
            "<string>"
          ],
          "limit": 123,
          "prompt": "<string>"
        }
      ],
      "capabilities": [
        {
          "slug": "<string>"
        }
      ],
      "mcpClients": [
        {
          "name": "<string>",
          "url": "<string>",
          "authentication": {
            "issuedAt": "<string>",
            "accessToken": "<string>",
            "expiresIn": 123,
            "refreshToken": "<string>",
            "scope": "<string>",
            "tokenType": "<string>",
            "clientId": "<string>"
          },
          "disabledToolSlugs": [
            "<string>"
          ]
        }
      ],
      "systemPrompt": "<string>",
      "withReasoning": true,
      "temperature": 123,
      "maxSteps": 123,
      "integrationSlug": "<string>",
      "connectorUuid": "<string>",
      "languageModelSlug": "<string>",
      "evaluatedTools": {},
      "usage": {
        "tokensUsedCount": 123,
        "creditsUsedCount": 123,
        "languageModelSlug": "<string>",
        "connectorUuid": "<string>"
      },
      "output": "<unknown>",
      "meta": {},
      "suggestedActions": [
        {
          "text": "<string>",
          "tools": [
            {
              "slug": "<string>"
            }
          ]
        }
      ],
      "temporalWorkflowId": "<string>",
      "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

chatUuid
string
required

Chat identifier.

limit
string

Maximum number of messages to return.

offset
string

Number of messages to skip.

Response

Successful response

messages
Messages · object[]
required

List of messages.