---
title: "Trigger Agent Kill Switch"
method: POST
path: "/v1/agents/{agent_id}/kill_switch"
tags: ["agents"]
---

# Trigger Agent Kill Switch

`POST /v1/agents/{agent_id}/kill_switch`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/v1/agents/{agent_id}/kill_switch`
- Auth: API key in header `x-litellm-api-key`

Fire the agent's configured kill switch webhook. Proxy admin only.

LiteLLM only makes the configured HTTP call and reports what came back; it
does not change the agent's state in LiteLLM. Returns 200 when the webhook
answered 2xx, 502 with the same result body otherwise. Every attempt is
written to the audit log as a `kill_switch_fired` row against the agent.

Example Request:
```bash
curl -X POST "http://localhost:4000/v1/agents/123e4567-e89b-12d3-a456-426614174000/kill_switch" \
    -H "Authorization: Bearer <your_api_key>"
```

## Path parameters

- `agent_id` string, required

## Response `200`

Successful Response

- AgentKillSwitchResult
  - `agent_id` string, required
  - `error` string, nullable
  - `method` 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'GET', required
  - `response_body` string, nullable
  - `status_code` integer, nullable
  - `url` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/v1/agents/:agent_id/kill_switch/post.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)