Stop Agent
curl --request POST \
--url https://api.app.shinzo.ai/v1/agent/{id}/stop \
--header 'Authorization: Bearer <token>'Stop Agent
Stop an agent and shut down its pod. Workspace is preserved.
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 viaAuthorization: Bearer <token> header.
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 |