Get one conversation and its state
Retrieve a conversation you own, or any if your role can moderate. Missing, in another organisation or hidden from you all return the same 404.
GET
/
conversations
/
{conversation_id}
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/conversations/{conversation_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/conversations/${conversationId}`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"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" }
}
{ "code": "not_found", "message": "The requested resource was not found." }
You can read a conversation you own. A caller whose role can moderate conversations (
owner or admin) can read any conversation in the organization.
A conversation that does not exist, belongs to another organization, is not visible to you, or has a malformed ID all return the same 404. The response never tells you which.
A conversation stays readable after its assistant is disabled or archived, or loses its knowledge. Only asking a new question is refused then.
string
required
The conversation ID.
Response
string
required
The conversation ID.
string
required
The assistant that answers in this conversation.
string
required
The conversation title.
string
required
active or archived.string
required
idle, or awaiting_answer while a question is being answered. You cannot ask a new question
until it is idle again.integer
required
The number of messages. Each question and each answer counts as one.
string
required
ISO 8601 creation timestamp with a UTC offset.
string
required
ISO 8601 timestamp of the last change.
object
required
object
required
Your metadata entries.
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/conversations/{conversation_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/conversations/${conversationId}`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"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" }
}
{ "code": "not_found", "message": "The requested resource was not found." }
Last modified on November 7, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/conversations/{conversation_id}",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/conversations/${conversationId}`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"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" }
}
{ "code": "not_found", "message": "The requested resource was not found." }