Users / Memberships / Roles API Reference
PlatformEndpoint reference for users, memberships, invitations, roles, active context and audit history.
Identity
One user identity
Membership
Tenant affiliation
Role
Functional access
Context
Tenant + membership
Users
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /v1/users | List visible users |
| GET | /v1/users/{user_id} | Get visible user |
Memberships
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /v1/memberships | List memberships |
| POST | /v1/memberships | Create membership |
| GET | /v1/memberships/{id} | Get membership |
| PATCH | /v1/memberships/{id} | Update membership |
| POST | /v1/memberships/{id}/terminate | Terminate membership |
Invitations
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /v1/membership-invitations | Create invitation |
| POST | /v1/membership-invitations/{id}/accept | Accept invitation |
| POST | /v1/membership-invitations/{id}/revoke | Revoke invitation |
Roles
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /v1/roles | List public/tenant roles |
| PUT | /v1/memberships/{id}/roles | Assign membership roles |
Context
| Header | Purpose |
|---|---|
| X-Tenant-Id | Active tenant |
| X-Membership-Id | Active membership |
Audit
| Method | Endpoint |
|---|---|
| GET | /v1/membership-audit |
Response codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Validation error |
| 403 | Insufficient access |
| 404 | Not found in active context |
| 409 | Lifecycle / state conflict |