agent.update - Manus API

POST

/

v2

/

agent.update

UpdateAgent

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

{
  "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.}

Authorizations

x-manus-api-key

string

header

required

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

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.

file.uploadCreates a file record and returns a presigned upload URL. Upload the file content to the returned `upload_url` via PUT before it expires. Then use the `file.id` as `file_id` in [task.create](https://open.manus.ai/docs/v2/task.create) or [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessage) message content.

⌘I

UpdateAgent

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

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