Transfer Ownership
Hand ownership of your active account to another member. Each account has exactly one owner, who holds full access to every resource and is the only member that can transfer ownership or be billed for the account.
Only the current owner may call this endpoint — being granted members-admin permissions is not enough. After a successful transfer the named member becomes the new owner, and you (the previous owner) are demoted to a regular member holding the role you specify in old_owner_role_uuid. The target must already be a member of the account.
Request body
user_uuid string (uuid) Req
The
user_uuid of the member who will become the new owner. Look this up via /account/members.old_owner_role_uuid string (uuid) Req
The
uuid of the role to assign to you, the outgoing owner, once you become a regular member. Must be a role that belongs to this account.Deprecated: user_id and old_owner_role_id (integers) are still accepted until the sunset. Send user_uuid and old_owner_role_uuid; sending both forms for different objects is a 400 id_uuid_mismatch.
Response (200 OK)
success boolean
true when ownership was transferred.Errors
400 Bad Request
Missing
user_uuid or old_owner_role_uuid, a value that is not a uuid, both forms naming different objects (id_uuid_mismatch), or a target member that can't take ownership.401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, or the caller is not the current account owner.
404 Not Found
user_uuid is not a member of the active account, or old_owner_role_uuid is not a role of this account.Request
curl -X POST "https://api.ngris.com/v1/account/transfer-owner" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"user_uuid": "019a5f28-be41-7264-9ed2-2e6aceae8290",
"old_owner_role_uuid": "019a9625-4dd4-7506-aa4b-97bbf9a69640"
}'
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client._post_void("/account/transfer-owner", {
"user_uuid": "019a5f28-be41-7264-9ed2-2e6aceae8290",
"old_owner_role_uuid": "019a9625-4dd4-7506-aa4b-97bbf9a69640",
})
Response — 200 OK
{
"success": true
}
Was this helpful?