List chats

get/v1/chat/list

Retired. This endpoint answers 410 Gone and no longer works. It is documented for reference only; use the v2 agent API's Chat instead.

Page through the organization's chats, newest activity first by default. Each row is a lightweight summary (id, message count, timestamps); fetch a single chat with Retrieve a chat to read its messages.

Pagination is offset-based: pass skip and limit, and stop when pagination.hasMore is false.

Private keyapi.v1.chat.listNo demoDeprecated

Query parameters

limitinteger

Number of chats to return. Values below 1 or non-numeric values fall back to 20; values above 100 are clamped to 100.

default: 20min: 1max: 100

skipinteger

Number of chats to skip before the first returned row. Negative or non-numeric values are treated as 0.

default: 0min: 0

sortBystring

Field to sort on. Any other value silently falls back to updatedAt.

default: "updatedAt"updatedAtcreatedAtchatId

sortOrderstring

Sort direction. Anything other than asc is treated as desc.

default: "desc"ascdesc

Response

200One page of chat summaries.

array<ChatSummary>required

The page of chat summaries.

chatIdstring (uuid)required

Unique id of the chat.

e.g. "3f0c2a4e-8b1d-4c6a-9e2f-7a5b1c0d9e88"

messagesCountintegerrequired

Number of messages in the thread.

e.g. 4

messageCountintegerrequired

Same value as messagesCount, kept for compatibility.

e.g. 4

createdAtstring (date-time)required

When the chat was created.

e.g. "2026-09-12T14:03:11.412Z"

updatedAtstring (date-time)required

When the chat was last written to.

e.g. "2026-09-12T14:09:48.907Z"

ChatListPaginationrequired

Offset-based page metadata used by List chats.

totalintegerrequired

Total number of chats in the organization.

e.g. 137

limitintegerrequired

Page size that was applied after clamping.

e.g. 20

skipintegerrequired

Offset that was applied.

e.g. 0

hasMorebooleanrequired

Whether skip + limit is still below total.

e.g. true

Errors

Every error is JSON with a single error string unless noted. Match on the status code; the message is for humans.

410

This endpoint has been retired (v1/chat/list).

Always, for API callers. This check runs before authentication and consumes no quota.

curl -X GET "https://stylor.ai/api/v1/chat/list" \
  -H "Authorization: Bearer $STYLOR_API_KEY"

Response · 200

{
  "chats": [
    {
      "chatId": "3f0c2a4e-8b1d-4c6a-9e2f-7a5b1c0d9e88",
      "messagesCount": 4,
      "messageCount": 4,
      "createdAt": "2026-09-12T14:03:11.412Z",
      "updatedAt": "2026-09-12T14:09:48.907Z"
    },
    {
      "chatId": "c2b7e1a9-5d3f-4e8b-a6c0-1f2d3e4a5b6c",
      "messagesCount": 2,
      "messageCount": 2,
      "createdAt": "2026-09-11T09:21:05.118Z",
      "updatedAt": "2026-09-11T09:21:37.552Z"
    }
  ],
  "pagination": {
    "total": 137,
    "limit": 20,
    "skip": 0,
    "hasMore": true
  }
}