FruxonDocs
ApiAgent topics

List one page of a topic's joined message thread.

Joins the topic's sessions to their messages (`Topic → TopicSession.LegacyAgentSessionId → AgentMessage.SessionId`) and returns user / assistant / system turns newest-first — the chat viewer reverses each page for chronological display, matching the conversations viewer. Use the returned `nextPageToken` to load older slices. Returns 404 on an unknown / foreign topic and an empty page when the topic has no sessions yet.

GET
/v1/tenants/{tenant}/agents/{agent}/topics/{topic}/messages

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent.

topic*string

The unique identifier of the topic.

Formatuuid
tenant*string

The tenant identifier

Query Parameters

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/topics/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages"
{
  "items": [
    {
      "id": "string",
      "role": "string",
      "agentId": "string",
      "content": "string",
      "createdAt": 0,
      "occurredAt": 0,
      "sessionId": "string",
      "topicId": "00000000-0000-0000-0000-000000000000",
      "internal": false,
      "executionRecordId": "00000000-0000-0000-0000-000000000000",
      "traceStepId": "string",
      "origin": "AGENT_REPLY",
      "author": "PARTICIPANT",
      "attachments": [],
      "withheldReason": "HUMAN_OWNED_CONVERSATION",
      "withheldOwnership": "BOT"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}