---
title: "Emergency stop (alias of circuit-breaker trip)"
method: POST
path: "/api/v1/emergency-stop"
tags: ["Circuit Breaker"]
---

# Emergency stop (alias of circuit-breaker trip)

`POST /api/v1/emergency-stop`

## Request

- Base URL: `https://agent.getaxonflow.com`
- URL: `https://agent.getaxonflow.com/api/v1/emergency-stop`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/docs/api/v1/emergency-stop/post.ts> (a function with typed inputs; its response is checked against the schema)

Clearer Article 14 naming for `POST /api/v1/circuit-breaker/trip` —
identical handler, request body, and responses. **Enterprise only.**

## Headers

- `Authorization` string, required

## Request body

- CircuitBreakerTripRequest: Request body for trip / emergency-stop. Org and user identity come from the `X-Org-ID` (or `X-Tenant-ID`) and `X-User-ID` headers, not the body. Source of truth: `platform/agent/circuitbreaker/handler.go` (TripRequest).
  - `scope` 'global' | 'tenant' | 'client' | 'policy': Blast radius of the stop
  - `scope_id` string: Required for non-global scopes (tenant/client/policy ID)
  - `reason` 'manual' | 'policy_violation' | 'risk_level' | 'error_rate'
  - `comment` string: Free-text audit-trail comment
  - `duration_minutes` integer: Auto-expire after N minutes; 0 or omitted = indefinite

## Response `201`

Emergency stop activated (see the trip endpoint for the body shape)

## Other responses

- `400`: Invalid request body or parameters

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/revisions/34d30fcb7fa1?raw)