---
title: "Stop an AI assistant and cancel any running agent."
method: POST
path: "/ai_assistants/{assistant_id}/stop"
tags: ["AI Assistants"]
---

# Stop an AI assistant and cancel any running agent.

`POST /ai_assistants/{assistant_id}/stop`

## Request

- Base URL: `https://h2ogpte.genai.h2o.ai/api/v1`
- URL: `https://h2ogpte.genai.h2o.ai/api/v1/ai_assistants/{assistant_id}/stop`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/h2o/apis/h2ogpte-rest-api/docs/ai_assistants/:assistant_id/stop/post.ts> (a function with typed inputs; its response is checked against the schema)

Transitions the assistant to the stopped state. If the assistant is currently
running an agent, the running agent is also cancelled by setting the Redis stop
flag on the active chat question, which triggers a .terminate file push to the
agent container. The wake queue is drained and pending approvals are cancelled.

## Path parameters

- `assistant_id` string, required

## Response `204`

No Content

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `default`: Unexpected error

## Changes

- **2026-11-06** `a82a117320f4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/changes/ai_assistants/:assistant_id/stop/post.md)

---

[API](https://skmtc.dev/h2o/apis/h2ogpte-rest-api.md) - [All operations](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/revisions/a82a117320f4?raw)