Skip to main content
GET
cURL
Questions or issues? Contact us at api-support@manus.ai.
Auth:
  • API Key: Full access.
  • Standard OAuth client: Requires create_task or manage_all_tasks. With create_task, only tasks created by the same client; see Task visibility.
  • Trusted client: Full access.
Handle status: Read status_update events and respond as described in Task Lifecycle. Answer agent questions with task.sendMessage; confirm actions with task.confirmAction.Render output: Resolve file paths and manus-webdev:// links in assistant content as described in Attachments.

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. An OAuth client requires the create_task or manage_all_tasks scope unless it is a Trusted team client or Trusted public client. 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.

start_event_id
string

Start at this event, inclusive. Use a value from messages[].id. Cannot be combined with cursor. The response may still include next_cursor for following pages. If the ID appears only in verbose=true responses, use verbose=true or the event is not found.

order
enum<string>

Sort direction by timestamp.

  • desc (default) — newest first.
  • asc — oldest first.
Available options:
asc,
desc
verbose
boolean

Include detailed events.

  • false (default) — user_message, assistant_message, error_message, status_update, and user_stop only.
  • true — also tool_used (tools the agent invoked), plan_update (plan snapshots), new_plan_step (step additions), and explanation (agent reasoning).
slides_format
enum<string>

Format of slides attachments in the response.

  • html (default) — raw HTML slides.
  • pptx — slides converted to PowerPoint.
Available options:
html,
pptx
markdown_format
enum<string>

Format of Markdown attachments in assistant_message.attachments. An attachment is treated as Markdown when its filename ends in .md or .markdown, or its content_type contains markdown.

  • markdown (default) — the original Markdown file.
  • pdf — Markdown converted to PDF.
  • docx — Markdown converted to Word.

Only url changes: filename, content_type, file_uid, and version_uid still describe the source Markdown file. If conversion fails, url remains the original Markdown download.

Conversion runs before the response is returned, so response time grows with the number and size of Markdown attachments on the page. Pair it with start_event_id and limit=1 to convert only the message you need; do not use it for routine polling or full-page reads.

Available options:
markdown,
pdf,
docx

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.