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 managedAgentsListSessions 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.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Query Parameters
The caller-defined metadata key whose values to list. Same alphabet as on managedAgentsStartSession: 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 /managed-agents/v1/sessions/metadata-values: the distinct values one caller-defined metadata key takes across the sessions the caller may list.
Response body of GET /managed-agents/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.