Skip to main content

cast stop

Stop a running agent and destroy its sandbox.

Usage

cast stop <slug>

Arguments

ArgumentDescriptionRequired
slugThe agent’s unique slugYes

Example

cast stop my-agent
Stopping an agent destroys its sandbox. All files and state inside the sandbox will be lost. The agent can be redeployed with cast deploy.

What Happens

  1. The agent’s sandbox is destroyed via DELETE /agents/{slug}/sandbox
  2. The agent status changes to stopped
  3. The agent can no longer receive invocations until redeployed

See Also