API ReferenceChat Completions

List Chat Completions

View as Markdown

Returns a paginated list of chat completions (prompts) for the agent, with applied tags expanded as { id, name } and share metadata.

Authentication

x-api-keystring
API key for authentication
OR
AuthorizationBearer
Bearer token authentication

Headers

traceparentstringOptional

W3C Trace Context parent. When present, the Agent continues this trace for the request. Applies to all /api/v1 endpoints.

tracestatestringOptional
Optional W3C tracestate associated with traceparent.
baggagestringOptional
Optional W3C baggage. Prompt text is never copied onto spans.

Query parameters

pageintegerOptional>=1Defaults to 1
per_pageintegerOptional<=100Defaults to 50

Results per page (clamped to 100).

agent_idstringOptional
channel_idstringOptional
bible_idstringOptional
cachedstringOptional
clientstringOptional
config_idstringOptional
conversation_idstringOptional
device_idstringOptional
flaggedstringOptional
favoritedstringOptional
languagestringOptional
likedstringOptional
session_idstringOptional
user_idstringOptional
min_timestampstringOptional
max_timestampstringOptional

Response

Paginated list of chat completions
datalist of objectsOptional
totalintegerOptional
pageintegerOptional
per_pageintegerOptional

Errors

403
Forbidden Error
500
Internal Server Error