Get a page of Messages

get

{protocol}://{base-url}/ai/api/v1/chats/messages

Get a page of the requesting user's messages across their chats, ordered by creation time (descending).

Query Params

limit

integer

1 to 1000

Defaults to 100

The maximum number of messages to include in the response.

offset

integer

≥ 0

Defaults to 0

The start index of the messages to include in the response.

created_after

Only include messages created after this timestamp.

user_iddeprecated

Deprecated and ignored. Messages are scoped to the requesting user (Server Admins see all messages in the tenant); this parameter no longer affects the result.

tenant_user_id

If trusted internal caller or server admin, filter by tenant user id.

include_tags

array | null

Only include messages from chats with all of these tags. If a tag is in both include_tags and exclude_tags, exclude_tags takes precedence.

exclude_tags

array | null

Exclude messages from chats with any of these tags. If a tag is in both include_tags and exclude_tags, exclude_tags takes precedence.

input_only

If true, only return messages that have an input payload (user messages).

Responses

Language

Credentials

URL

Loading…

Response

Choose an example:

application/json

200Successful Response

401Authentication required. No valid session cookie or bearer token provided, or authentication failed.

402Tenant has no remaining tool calls. The request cannot be completed.

422Validation Error

500Internal server error during request processing.