Blue Guardrails

Get Conversation Facets

GET
/v1/conversations/facets

Browse workspace values, search substrings (3+ characters), or fetch filtered conversation ranges.

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/conversations/facets?field=tags"
{  "field": "tags",  "kind": "value",  "items": [    {      "value": "string",      "label": "string",      "kind": "value",      "key": null,      "tag_value": null    }  ]}