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
Authorization
bearerAuth 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.
In: header
Path Parameters
org_id*Org Id
Format
uuidRequest Body
application/json
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/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"}