Organization API: Organizations & Members: Transfer ownership
The 1 Organization API operations for transfer ownership.
Part of Organizations & Members.
Operations
Section titled Operations| Method | Path | Summary |
|---|---|---|
| POST | /api/v1/orgs/{org_slug}/transfer-ownership |
Hand the organization to another member, as its owner |
Hand the organization to another member, as its owner
Section titled Hand the organization to another member, as its ownerPOST /api/v1/orgs/{org_slug}/transfer-ownership
Hand the organization to another member, as its owner.
member_id is a row of GET /members; confirm is the
organization's slug, typed (case and surrounding spaces do not count).
The member becomes the owner at once, and the previous owner stays on the
team as an admin. The answer is the organization as GET answers
it, with the caller's new my_role.
403 for anyone but the owner's own coritan.com session; 422 for a wrong
confirm; 403 reauth_required without a fresh step-up
(POST /step-up); 404 for a member of another organization; 422 for the
owner themselves or a member whose account is not active.
Parameters
Section titled Parameters| Name | In | Type | Required |
|---|---|---|---|
org_slug |
path | string | yes |
Request body
Section titled Request bodyapplication/json (required)
| Field | Type | Required |
|---|---|---|
member_id |
integer | yes |
confirm |
string | no |
Responses
Section titled Responses| Status | Meaning |
|---|---|
200 |
Success. |
422 |
The request is not valid. detail lists each problem. |
Fields of a 200 response:
| Field | Type |
|---|---|
id |
integer |
slug |
string |
name |
string |
owner_user_id |
integer |
parent_org_id |
integer or null |
tier |
string |
status |
string |
billing_mode |
string |
platform_owned |
boolean |
max_customers |
integer |
max_services |
integer |
max_sub_resellers |
integer |
max_api_calls_month |
integer |
max_custom_products |
integer |
created_at |
string (date-time) or null |
updated_at |
string (date-time) or null |
my_role |
string or null |