GEgetaxonflow
Circuit Breaker

Trip circuit breaker (emergency stop)

Immediately halt matching AI operations for the organization (EU AI Act Article 14). Also exposed as the alias POST /api/v1/emergency-stop.

Identity comes from headers stamped by the auth middleware: X-Org-ID (falls back to X-Tenant-ID) selects the org; X-User-ID is required for the Article 14 audit trail (400 when missing). X-User-Email is recorded when present.

Enterprise only — community builds register no circuit-breaker routes (404).

post/api/v1/circuit-breaker/trip

Request

Headers

Authorizationstring required
Example:Basic bXktb3JnOkFYT04tVjIteHh4

OAuth2-style Basic authentication header. Format: Basic base64(clientId:clientSecret)

  • clientId: Your organization identifier (required)
  • clientSecret: Authentication credential (optional for community mode)

Not required when DEPLOYMENT_MODE=community.

Request body

scope'global' | 'tenant' | 'client' | 'policy'

Blast radius of the stop

scope_idstring

Required for non-global scopes (tenant/client/policy ID)

reason'manual' | 'policy_violation' | 'risk_level' | 'error_rate'
commentstring

Free-text audit-trail comment

duration_minutesinteger

Auto-expire after N minutes; 0 or omitted = indefinite

Response

Circuit tripped — matching requests are now blocked

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.