agent.list - Manus API

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>"
    }
  ]
}

^{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.

Hide child attributes

data.id

string

Unique identifier for the agent. Use this as agent_id in task.list (with scope=agent_subtask) to view this agent's subtasks.

data.task_id

string

The task ID associated with this agent's creation or configuration. Use task.detail to view the associated task.

data.nickname

string

Display name of the agent. Can be updated via agent.update.

data.about

string

Description or bio of the agent explaining its purpose and specialization. Can be updated via agent.update.

agent.detailRetrieves an agent's details including its nickname, description, and associated task. Use [agent.update](https://open.manus.ai/docs/v2/agent.update) to modify, or [task.list](https://open.manus.ai/docs/v2/task.list) with `scope=agent_subtask` to view this agent's subtasks.

⌘I

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>"
    }
  ]
}