archive_agents

Stop a list of agents and hide them from the panel, keyed by id, keeping their records and transcripts.

AgentwritesidempotentMCP tool

Prefer this to delete_agents: it is reversible with restore_agents, and search_transcripts still finds the conversations. The agents need not share a workflow. Returns not_found, and archives nothing at all, if any id given holds no agent, so a batch either goes whole or does not go. The children of any agent named here are archived with it, since a child rides along with its parent rather than standing on its own. A child named on its own is archived alone, which is how you finish with one reviewer while the agent it was reading for keeps working. An agent other than an orchestrator may archive only its own children, and naming any other agent refuses the whole batch as permission_denied.

Calling it#

curl -X POST http://127.0.0.1:8787/agent.v1.AgentService/ArchiveAgents \
  -H 'Content-Type: application/json' \
  -d '{
  "ids": [
    "<ids>"
  ]
}'

Request#

ArchiveAgentsRequest#

FieldTypeDescription
idslist of string

The agents to stop and hide, keeping their records and transcripts, children along with them. The batch goes whole or not at all.

required

Response#

Empty#

No fields.