agent.list

GET

agent.list

ListAgents

curl --request GET \
  --url https://api.manus.ai/v2/agent.list \
  --header 'x-manus-api-key: <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.}

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.

Authorizations

x-manus-api-key

string

header

required

Response

Agents retrieved successfully.

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: <api-key>'

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "task_id": "<string>",
      "nickname": "<string>",
      "about": "<string>"
    }
  ]
}

Getting Started

API Reference

Authorizations

Response