Chat API: Get, List, Delete

Overview

Beyond sending a message and getting a reply, the Chat API includes three endpoints for managing chat resources directly: Get a single chat by ID, List chats with filters and pagination, and Delete a chat. All three require a Bearer token passed in the Authorization header.

This page is the CRUD/lifecycle reference for chat resources. For the conceptual mechanics of how previousChatId and sessionId maintain conversation context across requests, see Chat API & Session Management.

Retrieves a single chat by its ID.

GET https://api.sulus.ai/chat/{id}

curl -X GET https://api.sulus.ai/chat/{id} \
  -H "Authorization: Bearer <your-api-key>"

Returns a Chat object on 200 OK.

Retrieves a paginated list of chats, with optional filters.

GET https://api.sulus.ai/chat

curl -X GET "https://api.sulus.ai/chat?assistantId=<assistant-id>&limit=50&sortOrder=DESC" \
  -H "Authorization: Bearer <your-api-key>"

Returns a paginated response containing the matching Chat objects.

Permanently deletes a chat by its ID.

DELETE https://api.sulus.ai/chat/{id}

curl -X DELETE https://api.sulus.ai/chat/{id} \
  -H "Authorization: Bearer <your-api-key>"

Returns the deleted Chat object on 200 OK. This is irreversible.