List agent chats

Returns paginated in-app agent chats for the authenticated user in the current workspace. Pinned chats are returned first, ordered by most recently pinned. Pass q to search by chat title instead of browsing history. Requires agents.chat in addition to api:read.

GET/agent-chats

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Query parameters

pagenumber

min 0 · default: 0

pageSizenumber

min 1 · max 100 · default: 30

qstring

Optional title search query

Responses

200

hasMorebooleanrequired

itemsAgentChatListItemDto[]required

Show properties

Array of AgentChatListItemDto

agentAgentChatAgentDto

Show properties

botUserIdobject

labelstring

providerobject

typestringrequired

chatTitleobject | null

createdAtstringrequired

idstringrequired

isDraftbooleanrequired

isEmptyDraftbooleanrequired

lastMessageAtstringrequired

pinnedAtobject | null

runIdstringrequired

statusstringrequired

Allowed:queuedrunningwaitingInputwaitingApprovaldonefailedcanceled

pagenumberrequired

pageSizenumberrequired

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

pagequerypageSizequeryqqueryOptional title search query

Request

curl -X GET "https://leadtime.app/api/public/agent-chats" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/agent-chats", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/agent-chats",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "hasMore": true,
  "items": [
    {
      "agent": {
        "botUserId": {},
        "label": "string",
        "provider": {},
        "type": "string"
      },
      "chatTitle": {},
      "createdAt": "string",
      "id": "string",
      "isDraft": true,
      "isEmptyDraft": true,
      "lastMessageAt": "string",
      "pinnedAt": {},
      "runId": "string",
      "status": "queued"
    }
  ],
  "page": 0,
  "pageSize": 0
}