Organizations
Transfer Ownership
Transfer ownership of the organization to another member.
Permissions:
- Requires
org:transfer(an owner) - Target user must be an existing member of the organization
Process:
- The caller becomes a regular member, the target becomes an owner
- A swap of exactly these two seats: organizations may hold SEVERAL owners (seated via add_member, invites or role promotion), and any other owner keeps their seat. This route exists for the common single-owner handoff, it does not enforce owner uniqueness.
Request Body:
new_owner_user_id: UUID of the member who will become the new owner
bearerAuthheader
AuthorizationBearer <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.
org_id*Org IdFormat
uuidapplication/json- body
new_owner_user_id*New Owner User IdFormat
uuidSuccessful Response
application/json- response
message*MessagePOST
curl -X POST 'https://api.fastmon.eu/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/transfer-ownership' \ -H 'Content-Type: application/json' \ -d '{ "new_owner_user_id": "b88deb90-d878-48a3-885c-7eabcd5efdff"}'{ "message": "string"}