List the conversations you can see

GET

conversations

curl --request GET "$MITHUNAI_URL/arukz/api/v1/conversations?limit=20" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/conversations",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    params={"limit": 20},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/conversations?limit=20`, {
  headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())

{
  "data": [
    {
      "id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
      "assistant_id": "5b0e2c7a-91d4-4f3e-8a6b-2d7c9e1f4a38",
      "title": "How do I rotate an API key?",
      "status": "active",
      "turn_state": "idle",
      "message_count": 2,
      "created_at": "2026-09-24T10:15:02.184311+00:00",
      "updated_at": "2026-09-24T10:15:09.402117+00:00",
      "owner": { "type": "service", "id": "9a7d3e51-2f6c-4b88-a0d4-6e1b5c3f7a92" },
      "metadata": { "source": "support-portal" }
    }
  ],
  "next_cursor": null,
  "has_more": false
}

{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }

Which conversations you see is decided by your credential, not by the query. A caller whose role can moderate conversations (owner or admin) sees every conversation in the organization. Every other caller, including an API key with the normal or editor role, sees only the conversations it owns. Results are ordered by creation time, newest first, and paged with a cursor. Loop until has_more is false; see Pagination. Archived conversations are not listed.

integer

default:"20"

The page size, from 1 to 100.

string

The next_cursor value from the previous page. A cursor this server did not issue returns 400. If the conversation a cursor points at has since been deleted, you get an empty page.

string

Only list conversations with this assistant. A value that is not a valid ID returns 400.

boolean

default:"false"

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

Response

object[]

required

The conversations on this page.

Show properties

string

The conversation ID.

string

The assistant that answers in this conversation.

string

The conversation title.

string

active or archived.

string

idle, or awaiting_answer while a question is being answered.

integer

The number of messages. Each question and each answer counts as one.

string

ISO 8601 creation timestamp with a UTC offset.

string

ISO 8601 timestamp of the last change.

object

The owning participant: type is user or service, and id is its identifier.

object

Your metadata entries.

string | null

required

Pass this back as cursor to get the next page. null on the last page.

boolean

required

Whether another page exists.

curl --request GET "$MITHUNAI_URL/arukz/api/v1/conversations?limit=20" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/conversations",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    params={"limit": 20},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/conversations?limit=20`, {
  headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())

{
  "data": [
    {
      "id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
      "assistant_id": "5b0e2c7a-91d4-4f3e-8a6b-2d7c9e1f4a38",
      "title": "How do I rotate an API key?",
      "status": "active",
      "turn_state": "idle",
      "message_count": 2,
      "created_at": "2026-09-24T10:15:02.184311+00:00",
      "updated_at": "2026-09-24T10:15:09.402117+00:00",
      "owner": { "type": "service", "id": "9a7d3e51-2f6c-4b88-a0d4-6e1b5c3f7a92" },
      "metadata": { "source": "support-portal" }
    }
  ],
  "next_cursor": null,
  "has_more": false
}

{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }

Last modified on September 26, 2026

⌘I

curl --request GET "$MITHUNAI_URL/arukz/api/v1/conversations?limit=20" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

response = requests.get(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/conversations",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    params={"limit": 20},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/conversations?limit=20`, {
  headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())

{
  "data": [
    {
      "id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
      "assistant_id": "5b0e2c7a-91d4-4f3e-8a6b-2d7c9e1f4a38",
      "title": "How do I rotate an API key?",
      "status": "active",
      "turn_state": "idle",
      "message_count": 2,
      "created_at": "2026-09-24T10:15:02.184311+00:00",
      "updated_at": "2026-09-24T10:15:09.402117+00:00",
      "owner": { "type": "service", "id": "9a7d3e51-2f6c-4b88-a0d4-6e1b5c3f7a92" },
      "metadata": { "source": "support-portal" }
    }
  ],
  "next_cursor": null,
  "has_more": false
}

{ "code": "validation_error", "message": "'limit' must be between 1 and 100." }

Get started

Conversations

Assistants

Models

Knowledge

Widget deployments

Widget (public)

MCP

API keys

Members

Analytics

Support access

Branding

Operations

List the conversations you can see

Response

​Response

Response