MonetaryAI / Docs
API ReferenceMemberships

Add a user through a recipient-bound membership invitation

Creates a 24-hour, one-time invitation. Email delivery permits recipient-bound activation of a new identity and never returns the token. Email-disabled legacy manual delivery returns a token usable only by an existing identity. Neither response confirms delivery. Company permission: `createMembershipInvitation`. Defaults: ADMIN. Current company role permissions and active membership are checked on every request; signed legacy role claims alone do not authorize this operation.

POST
/api/v1/membership-invitations

Authorization

bearerAuth
headerAuthorizationBearer <token>

Obtained from POST /api/v1/auth/login, on the tenant's own subdomain. Presenting it on another tenant's subdomain is a 403.

Request Body

application/json
  1. body
email*string
Formatemail
Length0 <= length <= 320
roles*array<>
Items1 <= items <= 5

Response Body

Legacy manual invitation created; raw token returned once

*/*
  1. response
expiresAt?string
Formatdate-time
invitationId?string
Formatuuid
token?string

Raw one-time token only for legacy manual delivery; null when email dispatch is selected

curl -X POST 'https://api.monetaryai.uz/api/v1/membership-invitations' \  -H 'Content-Type: application/json' \  -d '{  "email": "user@example.com",  "roles": [    "string"  ]}'
{  "expiresAt": "2019-08-24T14:15:22Z",  "invitationId": "550a4884-8473-4f2e-a6cf-551c16767d59",  "token": "string"}