Get Message Facets
List run-tag facets for messages matching a message filter.
Query Parameters
field*string
Message facet field to fetch.
Value in
"conversation.tags" | "origin_run_tags" | "messages.origin_run_tags" | "generation_model" | "tool_name" | "issue_labels" | "issue_count" | "created_at" | "conversation.message_count"filter?|
Message filter expression used to scope facet counts.
q?|
Case-insensitive substring search; value facets require at least 3 trimmed characters. Map facets match the whole query against key OR value; '=' and ':' are not separators.
limit?integer
Maximum eligible suggestions to collect before sorting that subset by capped count and value; not global top-N.
Default
20Range
0 < value <= 100Header Parameters
x-workspace-id?|
Workspace UUID for session-authenticated calls.
Response Body
application/json
application/json
curl -X GET "https://loading/v1/messages/facets?field=conversation.tags"{
"field": "conversation.tags",
"kind": "value",
"count_by": "message",
"items": [
{
"value": "string",
"label": "string",
"count": 1,
"has_more": true,
"kind": "value",
"key": "string",
"tag_value": "string"
}
],
"min": 0,
"max": 0
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}