Skip to main content
GET
/
v2
/
task.listMessages
cURL
curl --request GET \
  --url 'https://api.manus.ai/v2/task.listMessages?task_id=<string>&order=desc&limit=10' \
  --header 'x-manus-api-key: <api-key>'
{
  "ok": true,
  "request_id": "<string>",
  "task_id": "<string>",
  "messages": [
    {
      "id": "<string>",
      "timestamp": 123,
      "user_message": {
        "content": "<string>",
        "attachments": [
          {
            "filename": "<string>",
            "url": "<string>",
            "content_type": "<string>"
          }
        ]
      },
      "assistant_message": {
        "content": "<string>",
        "attachments": [
          {
            "filename": "<string>",
            "url": "<string>",
            "content_type": "<string>"
          }
        ]
      },
      "error_message": {
        "error_type": "<string>",
        "content": "<string>"
      },
      "status_update": {
        "status_detail": {
          "waiting_for_event_id": "<string>",
          "waiting_for_event_type": "<string>",
          "waiting_description": "<string>",
          "confirm_input_schema": {}
        },
        "brief": "<string>",
        "description": "<string>"
      },
      "tool_used": {
        "tool": "<string>",
        "action_id": "<string>",
        "brief": "<string>",
        "description": "<string>",
        "message": {
          "action": "<string>",
          "param": "<string>"
        }
      },
      "plan_update": {
        "steps": [
          {
            "title": "<string>",
            "started_at": 123,
            "end_at": 123
          }
        ]
      },
      "new_plan_step": {
        "step_id": "<string>",
        "title": "<string>"
      },
      "explanation": {
        "content": "<string>"
      },
      "structured_output_result": {
        "success": true,
        "value": {},
        "error": "<string>"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://open.manus.ai/docs/llms.txt

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

Questions or issues? Contact us at api-support@manus.ai.
OAuth scope: create_task or manage_all_tasks — see the OAuth2 guide. With create_task scope, can only access tasks created by this OAuth app.
Shortcut: Use agent-default-main_task as task_id to read the IM agent’s conversation history.Status handling: Check status_update events — running → keep polling, stopped → read results, waiting → respond with task.sendMessage or task.confirmAction, error → read error details.Structured Output: If the task was created with structured_output_schema, a structured_output_result event appears after the task stops. See the Structured Output guide.See the Task Lifecycle guide for the complete flow.

Headers

​
x-manus-api-key
string

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

​
Authorization
string

OAuth2 access token in Bearer {token} format. Provide either this or x-manus-api-key, not both. See the OAuth2 guide.

Example:

"Bearer {access_token}"

Query Parameters

​
task_id
string
required

The unique identifier of the task to list messages for. Supports the shortcut agent-default-main_task for the IM agent's main task.

​
limit
integer

Number of messages to return per page. Default: 50, Range: 1-200.

​
cursor
string

Pagination cursor from the previous response's next_cursor field. Omit for the first page.

​
order
enum<string>

Sort direction by timestamp. "desc" (default) returns newest first, "asc" returns oldest first (chronological order).

Available options:
asc,
desc
​
verbose
boolean

When true, includes detailed events: tool_used (tools the agent invoked), plan_update (full plan snapshots), new_plan_step (individual step additions), and explanation (agent reasoning). Default: false — only returns user_message, assistant_message, error_message, status_update, and user_stop.

​
slides_format
enum<string>

Format for slides attachments in the response. "html" (default) returns raw HTML slides. "pptx" auto-converts HTML slides to PowerPoint format.

Available options:
html,
pptx

Response

Messages retrieved successfully.

​
ok
boolean

Whether the request was successful.

Example:

true

​
request_id
string

Unique identifier for this API request.

​
task_id
string

The task ID these messages belong to.

​
messages
object[]

Array of task event objects representing the conversation and agent activity.

​
has_more
boolean

Whether there are more messages beyond this page.

​
next_cursor
string

Cursor for fetching the next page. Only present when has_more is true.