Stop Agent

Stop Agent

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

POST

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.

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

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Authentication

Example Request

Example Response

Status Codes

​Authentication

​Example Request

​Example Response

​Status Codes

Authentication

Example Request

Example Response

Status Codes