Membership invitations
PlatformInvite an existing or new Mediloop user to join an organization tenant with a predefined role.
Identity
One user identity
Membership
Tenant affiliation
Role
Functional access
Context
Tenant + membership
Overview
Invite
Create a tenant-scoped invitation
Accept
Link the authenticated user
Expire
Automatically invalidate stale invitations
Invitation model
| Field | Description |
|---|---|
| tenant_id | Target tenant |
| Intended recipient | |
| roles | Roles proposed for the membership |
| expires_at | Invitation expiration |
| status | pending, accepted, revoked, expired |
Create invitation
POST /v1/membership-invitationsCopy
{
"email": "doctor@example.com",
"tenant_id": "tnt_123",
"roles": ["doctor"]
}Accept invitation
Acceptance requires authenticated identity matching and policy checks before an active membership is created.
Expiry & revocation
Never reactivate an expired or revoked invitation token. Issue a new invitation.