agent.detail - Manus API

GET

/

v2

/

agent.detail

cURL

curl --request GET \
  --url 'https://api.manus.ai/v2/agent.detail?agent_id=<string>' \
  --header 'x-manus-api-key: <api-key>'

{
  "ok": true,
  "request_id": "<string>",
  "agent": {
    "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 this agent: Use task.sendMessage with the agent’s task_id to send messages to its main task.View subtasks: Use task.list with scope=agent_subtask and this agent’s ID to list all subtasks.

Headers

x-manus-api-key

string

required

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

Query Parameters

agent_id

string

required

The unique identifier of the agent to retrieve.

Response

Agent retrieved successfully.

ok

boolean

Whether the request was successful.

Example:

true

request_id

string

Unique identifier for this API request.

agent

object

The agent object with full details.

Hide child attributes

agent.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.

agent.task_id

string

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

agent.nickname

string

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

agent.about

string

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

agent.updateUpdates an agent's nickname and description. Use [agent.detail](https://open.manus.ai/docs/v2/agent.detail) to view current values before updating.

⌘I

cURL

curl --request GET \
  --url 'https://api.manus.ai/v2/agent.detail?agent_id=<string>' \
  --header 'x-manus-api-key: <api-key>'

{
  "ok": true,
  "request_id": "<string>",
  "agent": {
    "id": "<string>",
    "task_id": "<string>",
    "nickname": "<string>",
    "about": "<string>"
  }
}