agent.list

Lists all custom agents in your account. Use the returned IDs in task.list with scope=agent_subtask to view subtasks, or in agent.detail for full details. See the Agents guide.

GET /v2/agent.list

ListAgents

cURL

curl --request GET \
  --url https://api.manus.ai/v2/agent.list \
  --header 'x-manus-api-key: <x-manus-api-key>'

200

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

^{Questions or issues? Contact us at [e-mail].}

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

200

application/json

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.