Skip to main content
Transfers ownership of this org team to another active human member (not an API key, not a virtual member). The caller becomes an admin and can no longer perform owner-only operations after the transfer, including this one. A retry with the same Idempotency-Key replays the first result to the same caller only; anyone else is refused. Another transfer of the same team in progress answers 409; retry.
High-risk operation. It takes effect immediately. Read what it changes, above, before you call it.
Permission required: team owner only

Headers

string
Optional. Retrying with the same value replays the first result for the same caller.

Request Body

string
required
principal_id of an active human member who will become the team owner

Response

object

Errors

Errors answer with success: false, a message and an error_code. See Error Codes for every code.