Skip to main content
POST
/
v1
/
agent
/
{id}
/
stop
Stop Agent
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

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