Skip to main content
GET
List the caller-defined metadata keys sessions carry

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization 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.

Minimum string length: 1

Response

Response body of GET /managed-agents/v1/sessions/metadata-keys: the distinct caller-defined metadata keys across the sessions the caller may list.

Response body of GET /managed-agents/v1/sessions/metadata-keys: the distinct caller-defined metadata keys across the sessions the caller may list.

keys
string[]
required

Distinct caller-defined metadata keys carried by sessions the caller may list, sorted. Always an array; empty when no listed session carries metadata.

truncated
boolean

True when the organization carries more distinct keys than the response holds. The list is sorted, so the missing keys sort after the last one returned.