---
title: "Get AI chat processing status"
method: GET
path: "/v1/ai/chat/{chat-id}/status"
tags: ["AI Chat"]
---

# Get AI chat processing status

`GET /v1/ai/chat/{chat-id}/status`

Poll for the current processing status of an AI chat session.
Returns the status (idle, processing, completed, or error) along with
any pending question, completed response, or error message.

## Path parameters

- `chat-id` integer, required

## Response `200`

Status retrieved successfully

- object
  - `status` 'idle' | 'processing' | 'completed' | 'error' — Current processing state
  - `pendingQuestion` PendingQuestion — Question raised by the AI assistant and awaiting an answer from the user
    - `id` integer — Unique question identifier, to be sent back when answering
    - `type` 'confirmation' | 'multipleChoice' — Question type
    - `confirmationType` integer — Button labels to present for a confirmation question (0=approve/reject, 1=yes/no, 2=confirm/cancel)
    - `text` string — Question text to present to the user
    - `context` string — Additional context for the question (empty string if not provided)
    - `expiresAt` integer — Time when the question expires, as UNIX timestamp
    - `options` string[] — Available answer options (present only for multipleChoice questions)
  - `currentFunction` string, nullable — Name of the function currently being executed by AI (present when status is processing)
  - `response` string, nullable — AI response text (present when status is completed)
  - `errorMessage` string — Error description (present when status is error)

## Other responses

- `400` — Invalid chat ID
- `401` — Unauthorized
- `403` — Access denied
- `404` — Chat session not found

## Changes

- **2026-09-04** `4e1f9580c5b0` — 1 breaking, 1 info
  - the `pendingQuestion` response's property type changed from no type to `object` for status `200`
  - added `#/components/schemas/PendingQuestion` to the `pendingQuestion` response property `allOf` list for the response status `200`

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/ai/chat/:chat-id/status/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/6eac6acac8bf?raw)