Skip to main content
GET
/
api
/
chats
cURL
curl -X GET "https://app.cotool.ai/api/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,
  "feedbackByEvent": {}
}

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

Query Parameters

limit
integer
required
Required range: 1 <= x <= 100
offset
integer
required
Required range: x >= 0
Required string length: 1 - 200
titleOnly
string
pinnedOnly
string
excludePinned
string

Response

200 - application/json

Successful response

chats
object[]
required
totalCount
integer
required
feedbackByEvent
object