Stop Agent

Stop an agent and shut down its pod. Workspace is preserved.

POST /v1/agent/{id}/stop

Stop Agent

cURL

curl --request POST \
  --url https://api.app.shinzo.ai/v1/agent/{id}/stop \
  --header 'Authorization: Bearer <token>'

Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.

id · string · required

Agent UUID

Example Request

curl -X POST https://api.app.shinzo.ai/v1/agent/a1b2c3d4-e5f6-7890-abcd-ef1234567890/stop \
  -H "Authorization: Bearer <token>"

Example Response

{
  "message": "Agent stopped successfully"
}

Stopping an agent shuts down its pod completely to save resources. The agent’s workspace and configuration are preserved. Use pause instead if you need filesystem access while the agent is idle.

Status Codes

Code	Description
200	Agent stopped successfully
400	Agent is already stopped
401	Unauthorized - invalid or missing authentication
404	Agent not found