Skip to main content
POST
/
v1
/
instances
/
{instance_id}
/
stop
curl -X POST https://api.chowder.dev/v1/instances/f47ac10b-58cc-4372-a567-0e02b2c3d479/stop \
  -H "Authorization: Bearer chd_org_abc123..."
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "my-assistant",
  "status": "stopped",
  "model_provider": "anthropic",
  "sandbox_provider": "sandbox",
  "sandbox_id": "sb_abc123",
  "gateway_url": "https://sb-abc123-18789.preview.sandbox.app",
  "openclaw_version": "v1",
  "openclaw_config": null,
  "region": null,
  "error_message": null,
  "created_at": "2026-02-14T16:00:00.000000+00:00",
  "updated_at": "2026-02-14T20:00:00.000000+00:00"
}
Stop a running instance. The OpenClaw gateway is shut down and the sandbox is hibernated — your files and state are preserved, but the instance won’t accept messages until you start it again. The instance must be in running status. Trying to stop an instance that isn’t running returns a 409 Conflict.
Requires an organization key (chd_org_*). Scoped keys cannot stop instances.

Path Parameters

instance_id
string
required
The ID of the instance to stop.

Response

Returns 200 OK with the instance object. The status field will be "stopped".
curl -X POST https://api.chowder.dev/v1/instances/f47ac10b-58cc-4372-a567-0e02b2c3d479/stop \
  -H "Authorization: Bearer chd_org_abc123..."
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "my-assistant",
  "status": "stopped",
  "model_provider": "anthropic",
  "sandbox_provider": "sandbox",
  "sandbox_id": "sb_abc123",
  "gateway_url": "https://sb-abc123-18789.preview.sandbox.app",
  "openclaw_version": "v1",
  "openclaw_config": null,
  "region": null,
  "error_message": null,
  "created_at": "2026-02-14T16:00:00.000000+00:00",
  "updated_at": "2026-02-14T20:00:00.000000+00:00"
}