Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header.
The authenticated user must be a full unrestricted administrator or have the OpenAiChatMessage-List role.
Query Parameters
The page number to retrieve.
The number of records per page.
The property name to sort results by (e.g. Name, CreatedOn).
Sort direction. 1 for ascending, -1 for descending.
Filters
OpenAiChatMessage_Business
Filter by Business Id.
OpenAiChatMessage_Content
Filter by Content.
OpenAiChatMessage_ChatSession
Filter by Chat Session.
OpenAiChatMessage_ResponderName
Filter by Responder Name.
OpenAiChatMessage_ChatMessageRole
Filter by Chat Message Role.
Range Filters
from_OpenAiChatMessage_Rating
Filter by rating greater than or equal to this value.
to_OpenAiChatMessage_Rating
Filter by rating less than or equal to this value.
from_OpenAiChatMessage_CreatedOn
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
to_OpenAiChatMessage_CreatedOn
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
from_OpenAiChatMessage_UpdatedOn
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
to_OpenAiChatMessage_UpdatedOn
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.
Code Examples
Simple listing
curl -X GET \
"https://spaces.nexudus.com/api/sys/openaichatmessages?page=1&size=15&orderBy=Content&dir=1" \
-H "Authorization: Bearer YOUR_TOKEN"
Filtering by Content
curl -X GET \
"https://spaces.nexudus.com/api/sys/openaichatmessages?OpenAiChatMessage_Content=example-value&orderBy=Content&dir=1" \
-H "Authorization: Bearer YOUR_TOKEN"
Range filters
curl -X GET \
"https://spaces.nexudus.com/api/sys/openaichatmessages?from_OpenAiChatMessage_UpdatedOn=2025-01-01T00:00&to_OpenAiChatMessage_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=-1" \
-H "Authorization: Bearer YOUR_TOKEN"
Response
200
The list of OpenAiChatMessage records matching the query. See the Get one OpenAiChatMessage endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each OpenAiChatMessage. The following fields are not included in the Records[] response: Action.To get all fields, fetch the full record using the Get one OpenAiChatMessage endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
Number of records per page.
The field used for sorting.
The sort direction (1 = ascending, -1 = descending).
Index of the first item on the current page.
Index of the last item on the current page.
Total number of matching records across all pages.
Whether there is a next page of results.
Whether there is a previous page of results.
{
"Records": [
{
"BusinessId": 0,
"UserId": null,
"Action": 0,
"Content": "",
"ChatSession": null,
"ResponderName": null,
"ChatMessageRole": null,
"Rating": null,
"Id": 87654321,
"UpdatedOn": "2025-01-15T10:30:00Z",
"CreatedOn": "2025-01-10T08:00:00Z",
"UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"UpdatedBy": "admin@example.com",
"IsNew": false,
"SystemId": null,
"ToStringText": "OpenAiChatMessage Example",
"LocalizationDetails": null,
"CustomFields": null
}
],
"CurrentPageSize": 15,
"CurrentPage": 1,
"CurrentOrderField": "Content",
"CurrentSortDirection": 1,
"FirstItem": 1,
"HasNextPage": false,
"HasPreviousPage": false,
"LastItem": 1,
"PageNumber": 1,
"PageSize": 15,
"TotalItems": 1,
"TotalPages": 1
}