> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Stop agent calls

> Immediately stop all live calls for an agent

<Callout type="warning">
  **Not available yet.** `POST /agents/{id}/stop-calls` is not implemented in the
  API — there is no bulk "stop all calls for an agent" endpoint. The shape below
  describes the intended contract only, so this page has no request runner.

  To end calls today, hang up individual live sessions from the dashboard. See
  [Hangup live calls](/docs/guides/live-calls/hangup-live-calls).
</Callout>

Terminates every currently in-progress call for the given agent. Useful as a kill
switch if an agent is misbehaving in production.

### Path parameters

<ParamField path="id" type="string" required>
  The agent ID
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.agentic-os.com/api/v1/agents/AGENT_ID/stop-calls \
    -H "Authorization: Bearer $AGENTIC_OS_API_KEY"
  ```

  ```python Python theme={null}
  requests.post(
      "https://api.agentic-os.com/api/v1/agents/AGENT_ID/stop-calls",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  ```
</CodeGroup>

### Response

```json theme={null}
{ "stopped": 3, "agentId": "550e8400-e29b-41d4-a716-446655440000" }
```