Skip to main content

Get Session

Required role: read or higher.

Retrieve login session information for your current user session.

This is the one route that answers a login without a resolved acting tenant: when the user belongs to several tenants (or none) and no Feldera-Tenant header selects one, the acting-tenant fields are null and memberships lists the tenants to pick from.

Responses
200

The response body contains current session information including tenant details.

Schema OPTIONAL
memberships object[]

The tenants this user may act in, from the membership table. Empty for principals that are not human logins (API keys, federated workloads, no-auth mode) and for platform owners without explicit memberships, who act in any tenant regardless.

name string

The tenant's name.

role string

Possible values: [read, write, admin, owner]

A role in the RBAC model. Declaration order defines the privilege order.

tenant_id uuid
role string OPTIONAL

Possible values: [read, write, admin, owner]

A role in the RBAC model. Declaration order defines the privilege order.

tenant_id uuid OPTIONAL
tenant_name string OPTIONAL

Acting tenant name; null exactly when tenant_id is.

500

Request failed.

Schema OPTIONAL
details

Detailed error metadata. The contents of this field is determined by error_code.

error_code string

Error code is a string that specifies this error type.

message string

Human-readable error message.