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_id. The target must already be a member of the account.
Request body
user_id int64
Required. The user id of the member who will become the new owner. Look this up via /account/members.
old_owner_role_id int64
Required. The role to assign to you, the outgoing owner, once you become a regular member. Must be a role that belongs to this account.
Response (200 OK)
success boolean
true when ownership was transferred.Errors
400 Bad Request
Missing
user_id or old_owner_role_id, a role that does not belong to this account, or a target that is not a member of the account.401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, or the caller is not the current account owner.
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_id": 2048, "old_owner_role_id": 7}'
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.account.transfer_owner(user_id=2048, old_owner_role_id=7)
Response — 200 OK
{
"success": true
}