List the messages in a widget thread
Read a widget thread’s questions and answers, oldest first, for instance to restore the panel after a reload. Needs the widget key and visitor token.
GET
/
widget
/
conversations
/
{conversation_id}
/
messages
// Runs on your website.
const MITHUNAI_API = `${MITHUNAI_URL}/mithunai/api/v1`
const WIDGET_KEY = 'mithunai_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'
const conversationId = sessionStorage.getItem('mithunai.conversation')
const response = await fetch(
`${MITHUNAI_API}/widget/conversations/${conversationId}/messages?limit=50`,
{
headers: {
'X-MITHUNAI-Widget-Key': WIDGET_KEY,
'X-MITHUNAI-Visitor-Token': sessionStorage.getItem('mithunai.visitorToken'),
},
},
)
const { data } = await response.json()
for (const message of data) console.log(message.role, message.text)
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/widget/conversations/0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a/messages?limit=50" \
--header "X-MITHUNAI-Widget-Key: mithunai_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
--header "X-MITHUNAI-Visitor-Token: $VISITOR_TOKEN" \
--header "Origin: https://docs.example.com"
{
"data": [
{
"id": "4a1b2c3d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"conversation_id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
"role": "user",
"sequence": 1,
"status": "complete",
"text": "How do I raise my rate limit?",
"citations": [],
"abstained": false,
"created_at": "2026-09-24T10:02:21.004118+00:00",
"model": null,
"finish_reason": null,
"idempotency_key": "q-7f3c1e",
"metadata": {}
},
{
"id": "9f8e7d6c-5b4a-4c3d-9e2f-1a0b9c8d7e6f",
"conversation_id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
"role": "assistant",
"sequence": 2,
"status": "complete",
"text": "Rate limits are set per plan. To request a higher limit, open a support ticket from the billing page and include your expected peak requests per minute [1].",
"citations": [
{
"source_id": "6e1d3c5b-9a7f-4b2e-8d0c-3f5a7b9d1e2f",
"ordinal": 1,
"title": "Rate limits",
"url": "https://docs.example.com/guides/rate-limits",
"snippet": "To request a higher limit, open a support ticket from the billing page.",
"anchor": "requesting-a-higher-limit",
"score": 0.82
}
],
"abstained": false,
"created_at": "2026-09-24T10:02:21.004118+00:00",
"model": "anthropic/claude-sonnet-5",
"finish_reason": "stop",
"idempotency_key": null,
"metadata": {}
}
],
"next_cursor": null,
"has_more": false
}
{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }
{ "code": "authentication_error", "message": "Authentication is required." }
{ "code": "authorization_error", "message": "This widget may not be embedded from that origin." }
{ "code": "not_found", "message": "The requested resource was not found." }
Call this from the visitor’s browser, for example to restore a thread after a page reload. It takes the embed’s public widget key in
X-MITHUNAI-Widget-Key, and the browser’s Origin must be allowed by both the deployment’s allowed_origins and the platform-wide widget allowlist. See Website widget.
You must also send the thread’s X-MITHUNAI-Visitor-Token. The token is checked before any message is read. A missing token, another thread’s token and an unknown conversation all return the same 404.
Messages come oldest first. Page through them with cursor; see Pagination. Render an assistant message as a finished answer only when its status is complete. An answer with abstained: true is a successful response in which the assistant said it could not find the answer in its knowledge; see How answers work.
A refusal made before the key and the origin are accepted (a missing or invalid key, an origin the deployment does not allow, or the per-address limit checked before the key is read) carries no Access-Control-Allow-Origin header, so in a cross-origin browser request fetch rejects with a network error instead of exposing the error body. Once the key is accepted and the origin is allowed, every response carries the header, refusals included, so your page can read a 404, a 429 and its Retry-After.
string
required
The conversation’s ID (UUID).
string
required
The deployment’s public widget key,
mithunai_wk_….string
required
The visitor token returned when this thread was started.
string
required
Set by the browser. It must exactly match an origin allowed for this deployment. When you call
from outside a browser, set it yourself.
integer
default:"50"
How many messages to return, from 1 to 100.
string
The
next_cursor from the previous page. Omit it for the first page.Response
object[]
required
The messages, oldest first.
Show properties
Show properties
string
required
The message’s ID (UUID).
string
required
The conversation it belongs to.
string
required
user for a visitor’s question, assistant for an answer.integer
required
Position in the conversation.
string
required
complete, pending (still being generated), interrupted (stopped part way) or failed. A
question is always complete.string
required
The message text.
object[]
required
Sources the answer is grounded in. Empty for a question and for an abstention.
Show properties
Show properties
string
Identifier of the cited passage. It stays the same while the document’s content is
unchanged and changes when changed content is re-ingested. It is not a knowledge source ID
or a document ID.
integer
The citation’s number, matching the
[n] marker in text.string
Document title. May be an empty string.
string | null
Link to the source.
string | null
The passage the answer relied on.
string | null
Section anchor within the source.
number | null
Retrieval relevance score.
boolean
required
true when the assistant declined to answer because its knowledge did not contain the answer.string
required
ISO 8601 in UTC.
string | null
required
The model that produced an answer.
null for a question.string | null
required
Why generation ended.
null for a question.string | null
required
The idempotency key sent with the question, if any.
object
required
Metadata sent with the question.
string | null
required
Pass as
cursor to get the next page, or null on the last page.boolean
required
Whether another page exists.
// Runs on your website.
const MITHUNAI_API = `${MITHUNAI_URL}/mithunai/api/v1`
const WIDGET_KEY = 'mithunai_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'
const conversationId = sessionStorage.getItem('mithunai.conversation')
const response = await fetch(
`${MITHUNAI_API}/widget/conversations/${conversationId}/messages?limit=50`,
{
headers: {
'X-MITHUNAI-Widget-Key': WIDGET_KEY,
'X-MITHUNAI-Visitor-Token': sessionStorage.getItem('mithunai.visitorToken'),
},
},
)
const { data } = await response.json()
for (const message of data) console.log(message.role, message.text)
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/widget/conversations/0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a/messages?limit=50" \
--header "X-MITHUNAI-Widget-Key: mithunai_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
--header "X-MITHUNAI-Visitor-Token: $VISITOR_TOKEN" \
--header "Origin: https://docs.example.com"
{
"data": [
{
"id": "4a1b2c3d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"conversation_id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
"role": "user",
"sequence": 1,
"status": "complete",
"text": "How do I raise my rate limit?",
"citations": [],
"abstained": false,
"created_at": "2026-09-24T10:02:21.004118+00:00",
"model": null,
"finish_reason": null,
"idempotency_key": "q-7f3c1e",
"metadata": {}
},
{
"id": "9f8e7d6c-5b4a-4c3d-9e2f-1a0b9c8d7e6f",
"conversation_id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
"role": "assistant",
"sequence": 2,
"status": "complete",
"text": "Rate limits are set per plan. To request a higher limit, open a support ticket from the billing page and include your expected peak requests per minute [1].",
"citations": [
{
"source_id": "6e1d3c5b-9a7f-4b2e-8d0c-3f5a7b9d1e2f",
"ordinal": 1,
"title": "Rate limits",
"url": "https://docs.example.com/guides/rate-limits",
"snippet": "To request a higher limit, open a support ticket from the billing page.",
"anchor": "requesting-a-higher-limit",
"score": 0.82
}
],
"abstained": false,
"created_at": "2026-09-24T10:02:21.004118+00:00",
"model": "anthropic/claude-sonnet-5",
"finish_reason": "stop",
"idempotency_key": null,
"metadata": {}
}
],
"next_cursor": null,
"has_more": false
}
{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }
{ "code": "authentication_error", "message": "Authentication is required." }
{ "code": "authorization_error", "message": "This widget may not be embedded from that origin." }
{ "code": "not_found", "message": "The requested resource was not found." }
Last modified on November 7, 2026
// Runs on your website.
const MITHUNAI_API = `${MITHUNAI_URL}/mithunai/api/v1`
const WIDGET_KEY = 'mithunai_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'
const conversationId = sessionStorage.getItem('mithunai.conversation')
const response = await fetch(
`${MITHUNAI_API}/widget/conversations/${conversationId}/messages?limit=50`,
{
headers: {
'X-MITHUNAI-Widget-Key': WIDGET_KEY,
'X-MITHUNAI-Visitor-Token': sessionStorage.getItem('mithunai.visitorToken'),
},
},
)
const { data } = await response.json()
for (const message of data) console.log(message.role, message.text)
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/widget/conversations/0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a/messages?limit=50" \
--header "X-MITHUNAI-Widget-Key: mithunai_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
--header "X-MITHUNAI-Visitor-Token: $VISITOR_TOKEN" \
--header "Origin: https://docs.example.com"
{
"data": [
{
"id": "4a1b2c3d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"conversation_id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
"role": "user",
"sequence": 1,
"status": "complete",
"text": "How do I raise my rate limit?",
"citations": [],
"abstained": false,
"created_at": "2026-09-24T10:02:21.004118+00:00",
"model": null,
"finish_reason": null,
"idempotency_key": "q-7f3c1e",
"metadata": {}
},
{
"id": "9f8e7d6c-5b4a-4c3d-9e2f-1a0b9c8d7e6f",
"conversation_id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
"role": "assistant",
"sequence": 2,
"status": "complete",
"text": "Rate limits are set per plan. To request a higher limit, open a support ticket from the billing page and include your expected peak requests per minute [1].",
"citations": [
{
"source_id": "6e1d3c5b-9a7f-4b2e-8d0c-3f5a7b9d1e2f",
"ordinal": 1,
"title": "Rate limits",
"url": "https://docs.example.com/guides/rate-limits",
"snippet": "To request a higher limit, open a support ticket from the billing page.",
"anchor": "requesting-a-higher-limit",
"score": 0.82
}
],
"abstained": false,
"created_at": "2026-09-24T10:02:21.004118+00:00",
"model": "anthropic/claude-sonnet-5",
"finish_reason": "stop",
"idempotency_key": null,
"metadata": {}
}
],
"next_cursor": null,
"has_more": false
}
{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }
{ "code": "authentication_error", "message": "Authentication is required." }
{ "code": "authorization_error", "message": "This widget may not be embedded from that origin." }
{ "code": "not_found", "message": "The requested resource was not found." }