COcotool
Agent Runs

List agent runs/chats

Retrieve a paginated list of runs/chats associated with a specific agent.

get/api/agents/{agentId}/chats

Request

  • Base URL
    https://app.cotool.ai
  • Auth
    HTTP bearer

Path parameters

agentIdstring uuid required

Unique identifier of the agent to list chats for

Query parameters

limitnumber

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

offsetnumber

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

Response

Successful response

totalCountnumber required

Total number of chats available for pagination

Example response

{
  "chats": [
    {
      "createdAt": "2025-06-17T12:34:56.789Z",
      "updatedAt": "2025-06-17T12:34:56.789Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.