---
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

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)