Blue Guardrails

Get Message Facets

List run-tag facets for messages matching a message filter.

GET
/v1/messages/facets

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 search text for value facets.

limit?integer

Maximum number of value facets to return.

Default20
Range0 < value <= 100

Header 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": 0,
      "kind": "value",
      "key": "string",
      "tag_value": "string"
    }
  ],
  "min": 0,
  "max": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}