Transfer organization ownership | Comp AI API

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.

POST /v1/organization/transfer-ownership

Transfer organization ownership

cURL

curl --request POST \
  --url https://api.trycomp.ai/v1/organization/transfer-ownership \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "newOwnerId": "mem_xyz789"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({newOwnerId: 'mem_xyz789'})
};

fetch('https://api.trycomp.ai/v1/organization/transfer-ownership', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.trycomp.ai/v1/organization/transfer-ownership"

payload = { "newOwnerId": "mem_xyz789" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

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

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

success · boolean

Example:

true

message · string

Example:

"Ownership transferred successfully"

currentOwner · object

Show child attributes

newOwner · object

Show child attributes