List the values one caller-defined metadata key takes
Returns the distinct values of one caller-defined metadata key across every session the caller may list, sorted and optionally narrowed to a case-sensitive prefix with q, for a typeahead over listSessions metadata filters. Sessions the caller’s access policy hides contribute nothing. A key no session carries returns an empty list rather than an error. When more values match than limit allows, truncated is true: narrow q instead of paging.
Authorizations
A Recursion API key, created in the console under API keys.
Query Parameters
The caller-defined metadata key whose values to list. Same alphabet as on startSession: letters, digits, '_', '.', and '-', up to 64 characters.
Case-sensitive prefix the returned values must start with, up to 512 characters. Omit to list every value up to limit.
Most distinct values to return. When more match, truncated is true; narrow q rather than asking for more.
1 <= x <= 200Response
Response body of GET /v1/sessions/metadata-values: the distinct values one caller-defined metadata key takes across the sessions the caller may list.
Response body of GET /v1/sessions/metadata-values: the distinct values one caller-defined metadata key takes across the sessions the caller may list.
Distinct values the key takes on sessions the caller may list, sorted, narrowed to the q prefix when one was given. Always an array; empty when nothing matches.
True when more distinct values match than limit allowed. The list is sorted, so narrow with a longer q prefix rather than paging.