List one visitor's own widget threads

GET

widget

conversations

// Runs on your website.
const MITHUNAI_API = `${MITHUNAI_URL}/arukz/api/v1`
const WIDGET_KEY = 'arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'

const response = await fetch(`${MITHUNAI_API}/widget/conversations`, {
  headers: {
    'X-ARUKZ-Widget-Key': WIDGET_KEY,
    'X-ARUKZ-Visitor-Token': sessionStorage.getItem('mithunai.visitorToken'),
  },
})
const { data } = await response.json()
console.log(data)

curl --request GET "$MITHUNAI_URL/arukz/api/v1/widget/conversations?limit=20" \
  --header "X-ARUKZ-Widget-Key: arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
  --header "X-ARUKZ-Visitor-Token: $VISITOR_TOKEN" \
  --header "Origin: https://docs.example.com"

{
  "data": [
    {
      "id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
      "assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
      "title": "How do I raise my rate limit?",
      "status": "active",
      "turn_state": "idle",
      "message_count": 2,
      "created_at": "2026-09-24T10:02:17.559310+00:00",
      "updated_at": "2026-09-24T10:02:24.910447+00:00",
      "owner": { "type": "widget", "id": "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" },
      "metadata": { "page": "/guides/rate-limits" }
    }
  ],
  "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." }

Call this from the visitor’s browser. It takes the embed’s public widget key in X-ARUKZ-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. Only threads started with the visitor token you send are returned. Without an X-ARUKZ-Visitor-Token header the response is an empty list, never other visitors’ threads. A visitor token belongs to one thread, so in practice this returns at most the one conversation that token unlocks. The server reads the embed’s limit most recent threads, across all visitors, and then keeps only the ones your token unlocks. An older thread can therefore be missing from the result even though its token is valid; fetch it directly with Get a widget conversation instead. This endpoint returns a single page: next_cursor is always null and has_more is always false. When a request is refused, the response 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.

The deployment’s public widget key, arukz_wk_….

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.

string

The visitor token returned when a thread was started. Without it the list is empty.

boolean

default:"false"

Include archived threads. Accepts true, false, 1 or 0, in any letter case. Any other value returns 400 validation_error.

integer

default:"20"

How many of the embed’s most recent threads to consider, from 1 to 100.

Response

object[]

required

The threads your token unlocks, newest first.

Show properties

string

required

The conversation’s ID (UUID).

string

required

The assistant the deployment embeds.

string

required

The thread’s title.

string

required

active or archived.

string

required

idle when ready for a question, or awaiting_answer while an answer is being generated.

integer

required

Number of messages, questions and answers together.

string

required

ISO 8601 in UTC.

string

required

ISO 8601 in UTC.

object

required

{"type": "widget", "id": <deployment ID>}.

object

required

The metadata sent when the thread was started.

string | null

required

Always null.

boolean

required

Always false.

// Runs on your website.
const MITHUNAI_API = `${MITHUNAI_URL}/arukz/api/v1`
const WIDGET_KEY = 'arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'

const response = await fetch(`${MITHUNAI_API}/widget/conversations`, {
  headers: {
    'X-ARUKZ-Widget-Key': WIDGET_KEY,
    'X-ARUKZ-Visitor-Token': sessionStorage.getItem('mithunai.visitorToken'),
  },
})
const { data } = await response.json()
console.log(data)

curl --request GET "$MITHUNAI_URL/arukz/api/v1/widget/conversations?limit=20" \
  --header "X-ARUKZ-Widget-Key: arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
  --header "X-ARUKZ-Visitor-Token: $VISITOR_TOKEN" \
  --header "Origin: https://docs.example.com"

{
  "data": [
    {
      "id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
      "assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
      "title": "How do I raise my rate limit?",
      "status": "active",
      "turn_state": "idle",
      "message_count": 2,
      "created_at": "2026-09-24T10:02:17.559310+00:00",
      "updated_at": "2026-09-24T10:02:24.910447+00:00",
      "owner": { "type": "widget", "id": "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" },
      "metadata": { "page": "/guides/rate-limits" }
    }
  ],
  "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." }

Last modified on September 26, 2026

⌘I

// Runs on your website.
const MITHUNAI_API = `${MITHUNAI_URL}/arukz/api/v1`
const WIDGET_KEY = 'arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'

const response = await fetch(`${MITHUNAI_API}/widget/conversations`, {
  headers: {
    'X-ARUKZ-Widget-Key': WIDGET_KEY,
    'X-ARUKZ-Visitor-Token': sessionStorage.getItem('mithunai.visitorToken'),
  },
})
const { data } = await response.json()
console.log(data)

curl --request GET "$MITHUNAI_URL/arukz/api/v1/widget/conversations?limit=20" \
  --header "X-ARUKZ-Widget-Key: arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
  --header "X-ARUKZ-Visitor-Token: $VISITOR_TOKEN" \
  --header "Origin: https://docs.example.com"

{
  "data": [
    {
      "id": "0e6a9b52-7d3f-4c18-a2e5-9b8c7d6e5f4a",
      "assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
      "title": "How do I raise my rate limit?",
      "status": "active",
      "turn_state": "idle",
      "message_count": 2,
      "created_at": "2026-09-24T10:02:17.559310+00:00",
      "updated_at": "2026-09-24T10:02:24.910447+00:00",
      "owner": { "type": "widget", "id": "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" },
      "metadata": { "page": "/guides/rate-limits" }
    }
  ],
  "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." }

Get started

Conversations

Assistants

Models

Knowledge

Widget deployments

Widget (public)

MCP

API keys

Members

Analytics

Support access

Branding

Operations

List one visitor's own widget threads

Response

​Response

Response