Skip to main content
POST
Makes one of your organisation’s members its owner. An organisation always has exactly one owner, so in the same step you become an admin. You keep your seat, your sign-in and everything an admin can do; you can no longer transfer ownership, and only the new owner can give it back. Only the current owner can do this. The person must already be a member of your organisation, and their account must be active. To hand the organisation to someone who is not a member yet, invite them first. Two other things happen:
  • Any API key you created with the owner role is revoked, because an admin cannot create one. Keys you created with other roles keep working. The response says how many were revoked.
  • Both of you are sent an email saying the owner has changed, if your deployment can send email. notified in the response says whether both messages went. The change stands either way.
This endpoint takes a signed-in console session, not an API key. Send the session cookies your browser received when you signed in, plus the X-CSRF-Token header set to the value of the csrf_token cookie. A request authenticated with an mithunai_sk_ key is refused with 403. There is no request body. If you are not the owner you get 403. Naming yourself, or a member whose account is not active, returns 409. A member who does not exist, a member of another organisation and a malformed ID all return the same 404. See Members.
string
required
The account ID (UUID) of the member who will become the owner, as returned in account_id by List members.
string
required
The value of your session’s csrf_token cookie (named __Host-csrf_token when the console is served over HTTPS without a shared cookie domain). A missing or mismatched token returns 401.

Response

object
required
The new owner, as a member with role owner.
object
required
You, as a member with role admin.
integer
required
How many owner-role API keys you had created were revoked.
boolean
required
true when both of you were sent an email about the change.
Last modified on November 7, 2026