agent.update

An API operation for changing an agent’s display name and description through the Manus API, a service interface for managing agents.

In plain words
What is it for?
Use it when renaming an agent, changing its description, or retrieving the request and agent details returned after an update.
Why use it?
It provides a defined way to update an agent’s identifying information and receive the updated agent record.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/0-soft/manus-mcp/agent.update
Clone the repo
git clone --depth 1 https://github.com/0-SOFT/Manus-MCP
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 563 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00563
Opus 5 $0.00000 $0.00282
Sonnet 5 $0.00000 $0.00113
Haiku 4.5 $0.00000 $0.00056

Measured 2d ago against content hash 76cffcae5abf, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

agent.update scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl --request POST \
ManusAPIDocs/api-reference/agents/agent.update.md · 70 lines

What it actually says

agent.update - Manus API

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

Authorizations

Parameter Type Location Required
x-manus-api-key string header required

Body

application/json

Parameter Type Description Required
agent_id string The unique identifier of the agent to update. required
nickname string New display name for the agent. optional
about string New description or bio for the agent. optional

Response

200 OK

application/json

Agent updated successfully.

Field Type Description
ok boolean Whether the request was successful. Example: true
request_id string Unique identifier for this API request.
agent object The updated agent object.
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.

Code Examples

cURL

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>",
  "nickname": "<string>",
  "about": "<string>"
}
'

200 Response Example

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

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 70 lines · 0 tokens per session scan A 76cffcae5abf

Subscribe to this mod's changes

agent.update is an agent published in the GitHub repository 0-SOFT/Manus-MCP (5 stars, last pushed 4mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 563 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.