Read team conversation messages¶
Read the public input and output messages of a team conversation.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams/{team_id}/sessions/{context_id}/messages
Before you call this API¶
Set BASE_URL to the product API prefix https://api.moi.matrixorigin.cn/v5; use the corresponding product API URL for a dedicated deployment.
Prepare product identity and object identifiers in the same environment.
Request¶
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions/$CONTEXT_ID/messages?limit=50&offset=0" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
Next-page example:
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions/$CONTEXT_ID/messages?limit=50&offset=50" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
Latest-window example:
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions/$CONTEXT_ID/messages?latest=true&limit=50" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
Parameter |
Location |
Type |
Required |
Description |
|---|---|---|---|---|
|
Path |
string |
Yes |
Current workspace ID; keep the product identity and headers in the same environment. |
|
Path |
string |
Yes |
Team ID from the team list or creation response. |
|
Path |
string |
Yes |
Team conversation ID from creation or the list. |
|
Queries |
boolean text |
No |
Only literal true enables the latest window. Use separately from ordinary pagination. |
|
Queries |
integer |
No |
Default 50, maximum 200. Nonpositive or invalid values use 50. |
|
Queries |
integer |
No |
Default 0; negative values use 0. |
In ordinary mode, stop when offset + items.length >= total or items is empty. Concurrent writes may affect offset pagination; total is not a stable snapshot.
Ordinary mode sorts by creation time and snapshot order ascending and uses limit/offset pagination. latest=true selects the newest window, ignores requested offset, restores chronological order, and returns the actual window offset. total counts input/output snapshots underlying the message projection, not tasks.
Successful response¶
{
"code": 0,
"data": {
"items": [
{
"id": "message-example",
"conversation_id": "context-example",
"task_id": "task-example",
"agent_workspace_id": "workspace-example",
"agent_id": "agent-example",
"role": "user",
"parts": [
{
"kind": "text",
"text": "整理资料"
}
],
"committed": false,
"created_at": "2026-11-12T01:00:00Z"
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
HTTP 200. Returns the corresponding object. Confirm writes with the corresponding read action.
Error responses¶
Errors and concurrency handling distinguishes parameter, version, member/session state, and admission failures.