Organization

Transfer organization ownership

Changed on

Transfers organization ownership to another member. The current owner will become an admin and keep all other roles. The new owner will receive the owner role while keeping their existing roles. Only the current organization owner can.

post/v1/organization/transfer-ownership

Request

  • Base URL
    https://api.betayum.com
  • URL
    https://api.betayum.com/v1/organization/transfer-ownership
  • Auth
    API key in header X-API-Key

Request body

newOwnerIdstring required

Member ID of the new owner

userIdstring

User ID of the current owner initiating the transfer (required for API key auth, ignored for JWT auth)

Example request

{
  "newOwnerId": "mem_xyz789",
  "userId": "usr_abc123def456"
}

Response

Not found - Organization or member not found

Forbidden - Only organization owner can transfer ownership

Unauthorized - Invalid or missing authentication

Bad request - Invalid input

Ownership transferred successfully

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Ownership transferred successfully",
  "currentOwner": {
    "memberId": "mem_abc123",
    "previousRoles": [
      "owner",
      "employee"
    ],
    "newRoles": [
      "admin",
      "employee"
    ]
  },
  "newOwner": {
    "memberId": "mem_xyz789",
    "previousRoles": [
      "admin"
    ],
    "newRoles": [
      "admin",
      "owner"
    ]
  }
}

Changes