Skip to main content
GET
/
v2
/
agent.list
ListAgents
curl --request GET \
  --url https://api.manus.ai/v2/agent.list \
  --header 'x-manus-api-key: <x-manus-api-key>'
{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "task_id": "<string>",
      "nickname": "<string>",
      "about": "<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.
Auth: API Key only — not available with OAuth tokens.
Talk to an agent: Use task.sendMessage with the agent’s task_id to send messages to an agent’s main task. See the Agents guide.

Headers

​
x-manus-api-key
string
required

API key for authentication. This endpoint does not support OAuth2 tokens. See Authentication.

Response

Agents retrieved successfully.

​
ok
boolean

Whether the request was successful.

Example:

true

​
request_id
string

Unique identifier for this API request.

​
data
object[]

Array of agent objects.