Skip to main content
GET
/
api
/
agents
/
{agentId}
/
chats
cURL
curl -X GET "https://app.cotool.ai/api/agents/:agentId/chats" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
{
  "chats": [
    {
      "id": "<string>",
      "organizationId": "<string>",
      "title": "<string>",
      "createdAt": "2025-06-17T12:34:56.789Z",
      "updatedAt": "2025-06-17T12:34:56.789Z",
      "experience": "chat",
      "modelAlias": "<unknown>",
      "status": "running",
      "userId": "<string>",
      "agentId": "<string>",
      "detectionId": "<string>",
      "parentChatId": "<string>",
      "detectionPlatform": "panther",
      "triggerId": "<string>",
      "triggerName": "<string>",
      "triggerSource": "<string>",
      "triggerDescription": "<string>",
      "statusMessage": "<string>",
      "result": "<string>",
      "structuredOutputSchema": {
        "type": "string",
        "title": "<string>",
        "description": "<string>",
        "properties": {},
        "items": "<unknown>",
        "required": [
          "<string>"
        ],
        "enum": [
          "<string>"
        ],
        "additionalProperties": true,
        "x-cotool": {
          "presetId": "classification"
        }
      },
      "shareToken": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "isPinned": true,
      "evalScore": 123,
      "evalExplanation": "<string>",
      "evalBulletSummary": [
        "<string>"
      ],
      "criticalIssue": {
        "category": "authentication",
        "explanation": "<string>"
      },
      "acceptanceCriteriaResults": [
        {
          "criterion": "<string>",
          "met": true,
          "explanation": "<string>"
        }
      ]
    }
  ],
  "totalCount": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.cotool.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Path Parameters

​
agentId
string<uuid>
required

Unique identifier of the agent to list chats for

Query Parameters

​
limit
number
default:10

Maximum number of chats to return (1-100, default: 10)

Required range: 1 <= x <= 100
​
offset
number
default:0

Number of chats to skip for pagination (default: 0)

Required range: x >= 0

Response

200 - application/json

Successful response

Paginated list of chats with total count for pagination

​
chats
object[]
required

Array of chat objects for this agent

​
totalCount
number
required

Total number of chats available for pagination