Blue Guardrails

Get Message Facets

GET
/v1/messages/facets

Search workspace-wide tags, run tags, models, tools and labels; ranges retain filters.

Query Parameters

field*|

Value or range facet field.

q?|

Empty lists suggestions; searches require 3+ characters per supplied key/value component. At least one component is required for key=value. Case-insensitive; ignored for ranges.

limit?Limit
Range0 < value <= 100
Default20
filter?|

Range fields only. Rejected (422) for value fields.

Header Parameters

x-workspace-id?|

Workspace UUID for session-authenticated calls.

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/messages/facets?field=conversation.tags"
{  "field": "conversation.tags",  "kind": "value",  "items": [    {      "value": "string",      "label": "string",      "kind": "value",      "key": null,      "tag_value": null    }  ]}