Skip to main content
GET
Roll up token and cost totals for a batch of sessions

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

Query Parameters

sessionIdAny
string[]
required

Comma-separated session ids to roll up, matching the ids returned by GET /v2/sessions. Ids that do not exist in this organization or are outside the caller's access policy are omitted from the response rather than erroring.

Required array length: 1 - 1000 elements

Response

OK

items
object[]
required

One roll-up row per requested session id that the caller can see. An empty array when none of the requested ids resolved. Ids naming nothing visible are omitted, so the result may be shorter than sessionIdAny and the order should not be assumed to match.