Skip to main content
GET
Get caller identity

Authorizations

Authorization
string
header
required

murmur API key: mur_<key_id>.

Response

A successful response.

The authenticated caller's identity. tenant is the isolation boundary (provider + org). principal is the actor — an identity-provider user or a service profile — and is unset for callers that own no self-listable namespace (plain token keys, agent runtime).

tenant
object

Tenant identifies an organization within a provider. It is the unit of multi-tenant scoping — all resources (agents, pools, VMs) belong to exactly one tenant.

principal
object

Principal identifies the actor a caller authenticates as within a tenant: either an IdP user (provider = the auth provider, account = username) or a service profile (provider = PROVIDER_SERVICE_PROFILE, account = profile name). It is the "who" that owns a self-listable namespace, distinct from Tenant's "where". The two map directly onto an AgentId's owner_provider and account. An unset Principal means the caller owns no self-listable namespace (e.g. a plain token key or an agent-runtime credential).

avatarUrl
string