Chat API

AI chat support system. This page lists all 12 endpoints in the Chat area of the Visual Sentinel REST API.

Base URL: https://visualsentinel.com. Unless an endpoint says otherwise it accepts an API key or a session cookie, see Authentication. Most error responses use the ErrorResponse shape, see Errors and Rate limits.

Endpoints

• Get chat messages: GET /api/chat
• Send chat message: POST /api/chat
• List chat sessions: GET /api/chat/sessions
• Create chat session: POST /api/chat/sessions
• Get chat session: GET /api/chat/sessions/{id}
• Update chat session: PATCH /api/chat/sessions/{id}
• Delete chat session: DELETE /api/chat/sessions/{id}
• Convert chat to support ticket: POST /api/chat/sessions/{id}/convert-to-ticket
• Submit chat feedback: POST /api/chat/feedback
• Upload chat attachment: POST /api/chat/upload
• List support tickets: GET /api/support/tickets
• Create support ticket: POST /api/support/tickets

Get chat messages

GET /api/chat

Get chat message history.

Authentication: session cookie only. API keys are refused.

Responses

• 200: Chat messages.

Send chat message

POST /api/chat

Send a message to the AI chat support system.

Authentication: session cookie only. API keys are refused.

Responses

• 200: AI response.

List chat sessions

GET /api/chat/sessions

Get all chat sessions for the current user.

Authentication: session cookie only. API keys are refused.

Responses

• 200: Chat sessions.

Create chat session

POST /api/chat/sessions

Start a new chat session.

Authentication: session cookie only. API keys are refused.

Responses

• 201: Session created.

Get chat session

GET /api/chat/sessions/{id}

Get a specific chat session with messages.

Authentication: session cookie only. API keys are refused.

Parameters

• id (path, string (uuid), required)

Responses

• 200: Chat session with messages.

Update chat session

PATCH /api/chat/sessions/{id}

Update a chat session (e.g., rename).

Authentication: session cookie only. API keys are refused.

Parameters

• id (path, string (uuid), required)

Responses

• 200: Session updated.

Delete chat session

DELETE /api/chat/sessions/{id}

Delete a chat session and its messages.

Authentication: session cookie only. API keys are refused.

Parameters

• id (path, string (uuid), required)

Responses

• 200: Session deleted.

Convert chat to support ticket

POST /api/chat/sessions/{id}/convert-to-ticket

Convert a chat session into a support ticket for human follow-up.

Authentication: session cookie only. API keys are refused.

Parameters

• id (path, string (uuid), required)

Responses

• 200: Ticket created.

Submit chat feedback

POST /api/chat/feedback

Submit feedback (thumbs up/down) for a chat response.

Authentication: session cookie only. API keys are refused.

Responses

• 200: Feedback submitted.

Upload chat attachment

POST /api/chat/upload

Upload an image or file attachment for a chat message.

Authentication: session cookie only. API keys are refused.

Request body (required): object (multipart/form-data).

Responses

• 200: File uploaded.

List support tickets

GET /api/support/tickets

Get all support tickets for the current user.

Responses

• 200: Support tickets.

Create support ticket

POST /api/support/tickets

Create a support ticket directly.

Responses

• 201: Ticket created.

Generated from the OpenAPI 3.1 specification at https://docs.visualsentinel.com/openapi.json, the same file the interactive reference reads.