Memberships

Platform

Manage the association between a user and an organization tenant, including role, status and lifecycle.

Identity

One user identity

Membership

Tenant affiliation

Role

Functional access

Context

Tenant + membership

Overview

Memberships are the authorization bridge between users and tenants. The same user can hold different roles in different tenants.

Field	Type	Description
id	string	Immutable membership identifier
user_id	string	Mediloop user linked to the membership
tenant_id	string	Tenant in which access is granted
roles	string[]	Functional roles assigned to the membership
status	enum	invited, active, suspended, terminated
created_at	date-time	Membership creation timestamp

GET membershipsCopy

GET /v1/memberships?user_id=usr_123&status=active
Authorization: Bearer $ACCESS_TOKEN

Concept	Description
Affiliation	Which tenant the user belongs to
Role assignment	Functional role(s) for that tenant
Status	Whether the membership grants access
Audit identity	Membership ID used for attribution of professional actions

Status	Meaning
invited	Invitation created; not yet active
active	Membership grants access
suspended	Temporarily blocked without deleting history
terminated	Ended permanently; historical record retained