# Organization API: Organizations & Members: Transfer ownership

> The 1 Organization API operations for transfer ownership.

Source: https://www.coritan.com/docs/api/reference/organizations/organizations-members/transfer-ownership/

Part of [Organizations & Members](/docs/api/reference/organizations/organizations-members/).

## Operations

| Method | Path | Summary |
| --- | --- | --- |
| POST | [`/api/v1/orgs/{org_slug}/transfer-ownership`](#op-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 {#op-post-api-v1-orgs-org-slug-transfer-ownership}

`POST /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

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `org_slug` | path | string | yes |

#### Request body

`application/json` (required)

| Field | Type | Required |
| --- | --- | --- |
| `member_id` | integer | yes |
| `confirm` | string | no |

#### 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 |
