---
title: "Create AI chat session"
method: POST
path: "/v1/ai/chat"
tags: ["AI Chat"]
---

# Create AI chat session

`POST /v1/ai/chat`

Create a new AI assistant chat session.

## Request body

- object
  - `incidentId` integer — Optional incident ID to associate with the chat session
  - `capabilities` string[] — Optional list of client capabilities. Recognized values - "visualizations" (enables visualization output from the assistant).

## Response `201`

Chat session created successfully

- object
  - `chatId` integer — ID of the created chat session
  - `created` string, date-time — Creation timestamp

## Other responses

- `400` — Invalid incident ID
- `401` — Unauthorized
- `500` — Failed to create chat session

## Changes

> 71 revisions in range; 8 could not be searched.

- **2026-06-10** `30e75dc6a94c` — 1 info
  - added the new optional request property `capabilities`
- **2026-05-08** `c6aaf3632e48` — 1 warning
  - removed the request property `capabilities`

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/ai/chat/post.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-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/b04ea2fbcedb/schema)