List the questions nobody could answer
Questions your assistants declined and answers rated unhelpful, newest first, optionally grouped by similarity. Never the answer or who asked.
GET
/
analytics
/
unanswered
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/analytics/unanswered?window=7d&limit=20" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/analytics/unanswered",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"window": "7d", "limit": 20},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ window: '7d', limit: '20' })
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/analytics/unanswered?${params}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"window": {
"start": "2026-09-17T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 104,
"by_reason": { "abstained": 97, "rated_unhelpful": 7 },
"questions": [
{
"question": "Does the SDK support retries with exponential backoff?",
"truncated": false,
"asked_at": "2026-09-24T09:12:48.331907+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "e2f94b17-6c0d-4a8e-b3f5-91d7c2a60e48",
"channel": "widget",
"reason": "abstained",
"note": null
},
{
"question": "How do I rotate the signing key for webhooks?",
"truncated": false,
"asked_at": "2026-09-23T16:40:05.018224+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "7a0c3e58-d19b-4f62-8e47-b5c1f9a2d306",
"channel": "user",
"reason": "rated_unhelpful",
"note": "This describes the old dashboard."
}
]
}
{
"window": {
"start": "2026-09-17T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 104,
"by_reason": { "abstained": 97, "rated_unhelpful": 7 },
"grouping": "meaning",
"groups": [
{
"representative": "Does the SDK support retries with exponential backoff?",
"count": 2,
"latest_asked_at": "2026-09-24T09:12:48.331907+00:00",
"questions": [
{
"question": "Does the SDK support retries with exponential backoff?",
"truncated": false,
"asked_at": "2026-09-24T09:12:48.331907+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "e2f94b17-6c0d-4a8e-b3f5-91d7c2a60e48",
"channel": "widget",
"reason": "abstained",
"note": null
},
{
"question": "does the sdk support retries with exponential backoff",
"truncated": false,
"asked_at": "2026-09-22T14:03:10.902114+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "1c9d4a73-0b6e-4f85-a2d7-3e5f8b9c0d14",
"channel": "service",
"reason": "abstained",
"note": null
}
]
}
]
}
{ "code": "validation_error", "message": "'window' must be one of 7d, 30d, 90d." }
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
Each row is a question that is a gap in your content, for one of two reasons.
abstained: the assistant said it could not answer from its sources rather than guess. rated_unhelpful: the assistant answered, and the person who asked rated the answer down, in the console or in the website widget. See How answers work.
Rows carry the question text but never the answer, the citations, or who asked. total counts every row in the window for both reasons, even when limit returns fewer.
Send group=true to get the same rows arranged into groups of similar questions, in groups instead of questions. Two questions share a group when they mean the same thing, or when at least four fifths of their words match after case, punctuation and common English words such as “how” and “the” are set aside. grouping says which comparison was used: when it is wording, two questions that mean the same thing in different words are in separate groups. Grouping covers only the rows this request returns, so a group’s count is a count within the page, not within the window.
Every read is recorded in your organization’s audit trail, grouped or not.
Because this returns other people’s questions, it requires the owner or admin role. Editors, members and dataset operators receive 403, even though editors can read usage counts.
string
default:"30d"
Trailing window ending now:
7d, 30d or 90d. Any other value returns 400.string
Limit the results to one assistant (UUID). A malformed ID returns
400; an ID from another
organization matches nothing.integer
default:"50"
Maximum rows to return, from 1 to 200. ASCII digits only.
string
default:"false"
true returns groups of similar questions in place of questions. false returns the plain
list. Any other value returns 400.Response
object
required
integer
required
How many rows match, for both reasons, regardless of
limit. A row whose question is no longer
stored is counted here but not listed.object
required
object[]
Unanswered questions, newest first. Present unless
group=true.Show properties
Show properties
string
required
The question text, cut to at most 500 characters.
boolean
required
true when question was cut.string
required
When the question was asked, ISO 8601 in UTC.
string
required
The assistant that was asked.
string
required
The conversation the question belongs to.
string | null
required
The kind of caller that asked:
user, service or widget. null when not recorded.string
required
abstained or rated_unhelpful. Treat a value you do not recognise as a gap of an unknown
kind.string | null
required
The note left with a thumbs down, on a
rated_unhelpful row. null otherwise.string
Present only with
group=true. How the groups were formed. meaning: every question was compared
by meaning. partial: some were compared by wording only. wording: all were compared by wording
only. Treat a value you do not recognise as partial.object[]
Present only with
group=true. Every returned row is in exactly one group, and a question unlike
any other is a group of one. Largest group first, then the most recently asked.Show properties
Show properties
string
required
The newest question in the group, which the others were compared with.
integer
required
How many of the returned rows are in the group.
string
required
When the newest question in the group was asked, ISO 8601 in UTC.
object[]
required
The group’s rows, newest first, each with the same fields as a row of the plain list.
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/analytics/unanswered?window=7d&limit=20" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/analytics/unanswered",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"window": "7d", "limit": 20},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ window: '7d', limit: '20' })
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/analytics/unanswered?${params}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"window": {
"start": "2026-09-17T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 104,
"by_reason": { "abstained": 97, "rated_unhelpful": 7 },
"questions": [
{
"question": "Does the SDK support retries with exponential backoff?",
"truncated": false,
"asked_at": "2026-09-24T09:12:48.331907+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "e2f94b17-6c0d-4a8e-b3f5-91d7c2a60e48",
"channel": "widget",
"reason": "abstained",
"note": null
},
{
"question": "How do I rotate the signing key for webhooks?",
"truncated": false,
"asked_at": "2026-09-23T16:40:05.018224+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "7a0c3e58-d19b-4f62-8e47-b5c1f9a2d306",
"channel": "user",
"reason": "rated_unhelpful",
"note": "This describes the old dashboard."
}
]
}
{
"window": {
"start": "2026-09-17T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 104,
"by_reason": { "abstained": 97, "rated_unhelpful": 7 },
"grouping": "meaning",
"groups": [
{
"representative": "Does the SDK support retries with exponential backoff?",
"count": 2,
"latest_asked_at": "2026-09-24T09:12:48.331907+00:00",
"questions": [
{
"question": "Does the SDK support retries with exponential backoff?",
"truncated": false,
"asked_at": "2026-09-24T09:12:48.331907+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "e2f94b17-6c0d-4a8e-b3f5-91d7c2a60e48",
"channel": "widget",
"reason": "abstained",
"note": null
},
{
"question": "does the sdk support retries with exponential backoff",
"truncated": false,
"asked_at": "2026-09-22T14:03:10.902114+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "1c9d4a73-0b6e-4f85-a2d7-3e5f8b9c0d14",
"channel": "service",
"reason": "abstained",
"note": null
}
]
}
]
}
{ "code": "validation_error", "message": "'window' must be one of 7d, 30d, 90d." }
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
Last modified on November 7, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/analytics/unanswered?window=7d&limit=20" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/analytics/unanswered",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"window": "7d", "limit": 20},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ window: '7d', limit: '20' })
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/analytics/unanswered?${params}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"window": {
"start": "2026-09-17T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 104,
"by_reason": { "abstained": 97, "rated_unhelpful": 7 },
"questions": [
{
"question": "Does the SDK support retries with exponential backoff?",
"truncated": false,
"asked_at": "2026-09-24T09:12:48.331907+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "e2f94b17-6c0d-4a8e-b3f5-91d7c2a60e48",
"channel": "widget",
"reason": "abstained",
"note": null
},
{
"question": "How do I rotate the signing key for webhooks?",
"truncated": false,
"asked_at": "2026-09-23T16:40:05.018224+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "7a0c3e58-d19b-4f62-8e47-b5c1f9a2d306",
"channel": "user",
"reason": "rated_unhelpful",
"note": "This describes the old dashboard."
}
]
}
{
"window": {
"start": "2026-09-17T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 104,
"by_reason": { "abstained": 97, "rated_unhelpful": 7 },
"grouping": "meaning",
"groups": [
{
"representative": "Does the SDK support retries with exponential backoff?",
"count": 2,
"latest_asked_at": "2026-09-24T09:12:48.331907+00:00",
"questions": [
{
"question": "Does the SDK support retries with exponential backoff?",
"truncated": false,
"asked_at": "2026-09-24T09:12:48.331907+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "e2f94b17-6c0d-4a8e-b3f5-91d7c2a60e48",
"channel": "widget",
"reason": "abstained",
"note": null
},
{
"question": "does the sdk support retries with exponential backoff",
"truncated": false,
"asked_at": "2026-09-22T14:03:10.902114+00:00",
"assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
"conversation_id": "1c9d4a73-0b6e-4f85-a2d7-3e5f8b9c0d14",
"channel": "service",
"reason": "abstained",
"note": null
}
]
}
]
}
{ "code": "validation_error", "message": "'window' must be one of 7d, 30d, 90d." }
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }