Pause Agent

Pause Agent

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

POST

agent

{id}

pause

Pause Agent

curl --request POST \
  --url https://api.app.shinzo.ai/v1/agent/{id}/pause \
  --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/pause \
  -H "Authorization: Bearer <token>"

Example Response

{
  "message": "Agent paused successfully"
}

Pausing an agent does not cancel any active tasks that are already in progress. Those tasks will complete normally. The agent simply stops accepting new messages until you resume it.

Status Codes

Code	Description
`200`	Agent paused successfully
`400`	Agent is already paused
`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