Skip to content

Update a Visible Agent

Change a visible agent name, team scope, role, or suspension state without recreating the binding.

Best for Workspace manager Updated April 3, 2026
CLI In this interface
4 steps Steps
3 interfaces Available in
Use this path when

The CLI update command is the terminal path for visible-agent maintenance.

What you'll finish here
  • Find the correct binding id.
  • Apply the smallest valid update.
  • Keep attribution stable while maintenance happens.

Where this happens

LabelValueNotes
Command./backlog.sh admin agents update <agentId> [options]Updates a visible agent.

Same Task, Other Interfaces

Use the version that matches where you are working now. The subject matter stays the same; the delivery changes by surface.

Do the work

  1. 1. Run the update command with the target binding id.
  2. 2. Add only the flags that describe the intended change: `--name`, repeated `--team-id`, `--role`, `--suspend`, or `--unsuspend`.
  3. 3. Review the result and rerun the list command if you want to verify the full visible-agent inventory.
  4. 4. Keep the same profile id in downstream systems unless the binding itself was intentionally retired.

Keep Going in Automation and Agents

Stay in the same interface and move to the next closest task in this topic when needed.

Nearby Guides

These guides stay close to the current workflow so you can keep moving without restarting discovery.