agent.update

Updates an agent’s nickname and description. Use agent.detail to view current values before updating.

POST /v2/agent.update

UpdateAgent

cURL

curl --request POST \
  --url https://api.manus.ai/v2/agent.update \
  --header 'Content-Type: application/json' \
  --header 'x-manus-api-key: <x-manus-api-key>' \
  --data '
{
  "agent_id": "<string>"
}
'

200

{
  "ok": true,
  "request_id": "<string>",
  "agent": {
    "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.

Headers

x-manus-api-key · string · required

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

Body

application/json

agent_id · string · required

The unique identifier of the agent to update.

nickname · string

New display name for the agent.

about · string

New description or bio for the agent.

Response

200

application/json

Agent updated successfully.

ok · boolean

Whether the request was successful.

Example:

true

request_id · string

Unique identifier for this API request.

agent · object

The updated agent object.

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.