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 (cookies + X-Organization-Id header).

POST /v1/organization/transfer-ownership

Try it

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"
}
'

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

Headers

X-Organization-Id · string

Organization ID (required for session auth, optional for API key auth)

Body

application/json

Transfer organization ownership to another member

newOwnerId · string · required

Member ID of the new owner

Example:

"mem_xyz789"

Response

default - application/json

Ownership transferred successfully

success · boolean

Example:

true

message · string

Example:

"Ownership transferred successfully"

currentOwner · object

Show child attributes

currentOwner. memberId · string

Example:

"mem_abc123"

currentOwner. previousRoles · string[]

Example:

["owner", "employee"]

currentOwner. newRoles · string[]

Example:

["admin", "employee"]

newOwner · object

Show child attributes

newOwner. memberId · string

Example:

"mem_xyz789"

newOwner. previousRoles · string[]

Example:

["admin"]

newOwner. newRoles · string[]

Example:

["admin", "owner"]