GET/v1/me/ai/conversations

Pinned conversations first, the most recently pinned on top, then the rest by their last message, newest first. The same order as the list on the website. Only the conversations of the chat this token talks to are here.

Paged with a cursor, as described in Pagination: limit (20 by default, at most 100) and starting_after with the next_cursor of the page before. The cursor is opaque. Pinning or asking something moves a conversation, so a list walked while that happens can show one twice or miss one. Start again from the top after either.

Request

curl "https://api.proppertrading.com/v1/me/ai/conversations?limit=2" \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f"

Response

{
    "data": [
        {
            "id": "01a16152-7e42-70cd-91a4-b6b80ee47daa",
            "object": "ai_conversation",
            "title": "Daily loss limit",
            "pinned": true,
            "surface": "trader_chat",
            "channel": "private-ai-chat.01a16152-7e42-70cd-91a4-b6b80ee47daa",
            "last_message_at": "2026-10-22T01:56:55+00:00",
            "created_at": "2026-10-22T01:55:58+00:00"
        },
        {
            "id": "01a16153-a212-723d-b566-135933fc9a3a",
            "object": "ai_conversation",
            "title": null,
            "pinned": false,
            "surface": "trader_chat",
            "channel": "private-ai-chat.01a16153-a212-723d-b566-135933fc9a3a",
            "last_message_at": "2026-10-22T01:57:13+00:00",
            "created_at": "2026-10-22T01:57:13+00:00"
        }
    ],
    "meta": {
        "request_id": "req_01m5gn79qm9g88tx68scfg1gc5",
        "has_more": true,
        "next_cursor": "eyJ2IjpbMCwiMTk3MC0wMS0wMSAwMDowMDowMC4wMDAwMDAiLCIyMDI2LTEwLTIyIDAxOjU3OjEzLjAwMDAwMCJdLCJpZCI6IjAxYTE2MTUzLWEyMTItNzIzZC1iNTY2LTEzNTkzM2ZjOWEzYSJ9"
    }
}

Field	Description
`id`	A uuid. What every other endpoint here takes in its path
`title`	Written by the assistant after its first answer, or by you through renaming. `null` until then, so show the first question instead
`channel`	The websocket channel of this conversation. Subscribe to it as it is, see the assistant
`last_message_at`	When somebody last wrote in it, the assistant included

Errors

Status	Code	Meaning
400	`invalid_cursor`	`starting_after` is not a cursor this list handed out
400	`invalid_limit`	`limit` is not a positive integer
400	`workspace_required`	Our own staff, without a firm in `Propper-Workspace`
403	`ai_unavailable`	The firm has the assistant switched off for this chat
403	`forbidden`	Staff whose role does not include `use_ai_chat`
403	`insufficient_scope`	This device does not hold `ai:read`

List conversations

Request

Response

Errors