Skip to main content
GET
/
sessions
/
{session_id}
/
messages
List messages for a session
curl --request GET \
  --url https://api.example.com/sessions/{session_id}/messages \
  --header 'x-user-id: <x-user-id>'
{
  "messages": [
    "<unknown>"
  ],
  "is_running": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.agentscope.io/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Path Parameters

​
session_id
string
required

Query Parameters

​
agent_id
string
required

Agent the session belongs to.

​
offset
integer
default:0

Pagination offset.

Required range: x >= 0
​
limit
integer
default:50

Max messages.

Required range: 1 <= x <= 200

Response

Successful Response

Response body for listing messages in a session.

​
messages
any[]
required

Messages in chronological order.

​
is_running
boolean
required

Whether the session is currently running.