Skip to main content
GET
cURL
Questions or issues? Contact us at api-support@manus.ai.
OAuth scope: create_task or manage_all_tasks — see the Open App guide. With create_task scope, can only access tasks created by this Open 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 Open App 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.