Members
Update Member Role
Change a member's role.
The only way to move someone between viewer / member / owner after they
joined. Two rules beyond the member:manage gate, both of which a role
bundle cannot express:
- Granting OWNER goes through the same check as an owner invite, so a partner organization cannot mint owners in a client it merely manages.
- The last owner cannot be demoted. An organization without an owner has nobody who can change settings, invite, or delete it.
bearerAuthheader
AuthentifizierungBearer <token>API token generated from the fastmon dashboard (Account → API Token) or at organization level (fmo_…, one that outlives its creator). Send as Authorization: Bearer fm_... or paste the full token (including its prefix) into the Authorize dialog.
member_id*Member IdFormat
uuidapplication/json- body
role*RoleThe new role.
Value in
"owner""member""viewer"Successful Response
application/json- response
id*IdIdentifier of the membership, not of the user.
Format
uuiduser_id*User IdThe account behind this membership.
Format
uuidemail*EmailThe member's email address.
full_name?Full NameThe member's name, when they gave one.
role*RoleWhat the member may do here.
Value in
"owner""member""viewer"totp_enabled?Totp EnabledWhether the account has two-factor authentication.
Default
falsecreated_at*Created AtWhen the member joined.
Format
date-timePATCH
curl -X PATCH 'https://api.fastmon.eu/members/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{ "role": "owner"}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "email": "string", "full_name": "string", "role": "owner", "totp_enabled": false, "created_at": "2019-08-24T14:15:22Z"}