opschain admin agent halt-resume
packs:agents
opschain admin agent halt-resume <agent-id> [--server <url>] [--auth-token <token>]
Lifts one agent's emergency halt (v2 AgentService.ResumeAgentHalt): the
agent may re-handshake and its surfaces serve again. The inverse of
opschain admin agent halt — a halt is reversible by design, which is what
distinguishes it from a revoke.
This lifts the per-agent halt only. When the agent's whole group is
halted the agent still reads halted (group) and stays refused until the
group's halt is lifted. The resume is recorded on the agent's audit
timeline with the acting administrator.
<agent-id> is the agent's member id — the ID column of
opschain admin agents list.
Flags
| Flag | Meaning |
|---|---|
--server <url> | Server base URL. Default: the active context, then OPSCHAIN_SERVER. |
--auth-token <token> | Admin bearer token override. Default: your opschain login session, then $OPSCHAIN_ADMIN_TOKEN, then the token stored by opschain admin login for that server. |
Output
Always a machine document (JSON unless -o yaml):
{
"halted": false,
"id": "01999a7e-…"
}
Exit codes
| Code | Meaning |
|---|---|
| 0 | The halt was lifted. |
| 1 | The server refused or failed the request (including a rejected admin token, or an unknown id). |
| 2 | Usage — wrong arguments, or no server / admin token resolvable. |
Named errors
a server is required — pass --server <url>, set OPSCHAIN_SERVER, or 'opschain context use <name>'— exit 2.this command needs a login or an admin token — run 'opschain login', pass --auth-token, set OPSCHAIN_ADMIN_TOKEN, or store one with 'opschain admin login'— exit 2.the server rejected the credential — run 'opschain login' again, or check the admin token— exit 1.agent <id> is not known to this estate — admin agent verbs take the ocr_ member id from 'opschain admin agents list' (a UUID is usually the identity-side service_account_id, not the member id)— the unknown, revoked or runner id 404, exit 1.
See also
opschain docs cli/admin-agent-halt— the verb this undoes.opschain docs cli/admin-agent-resume— lifting a drain instead.opschain docs cli/admin-agent-activity— the audit trail of halts and resumes.