Transfer organization ownership

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 perform this action. Supports both API key authentication (X-API-Key header) and session authentication (Bearer token or cookies).

POST /v1/organization/transfer-ownership

Transfer organization ownership

cURL

curl --request POST \
  --url http://localhost:3333/v1/organization/transfer-ownership \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "newOwnerId": "mem_xyz789",
  "userId": "usr_abc123def456"
}
'

default

{
  "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"
    ]
  }
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Body

application/json

Transfer organization ownership to another member

newOwnerId · string · required

Member ID of the new owner

Example:

"mem_xyz789"

userId · string

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

Example:

"usr_abc123def456"

Response

default - application/json

Ownership transferred successfully

success · boolean

Example:

true

message · string

Example:

"Ownership transferred successfully"

currentOwner · object

Show child attributes

newOwner · object

Show child attributes