---
title: "Transfer Ownership"
method: POST
path: "/workspaces/{workspace_id}/transfer-ownership"
tags: ["workspaces"]
---

# Transfer Ownership

`POST /workspaces/{workspace_id}/transfer-ownership`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/workspaces/{workspace_id}/transfer-ownership`
- Auth: HTTP bearer

Hand this workspace to another member. Owner-only, and the outgoing
owner becomes an admin rather than being dropped from the workspace —
same pattern Figma and Slack use, and it's reversible (the new owner can
transfer it right back).

Not available on the personal workspace: its `owner_id` is the account's
own identity, not a role inside a shared workspace, and billing hangs off
it directly (see Workspace's docstring).

`Workspace.plan` follows the owner: it is rebound to the new owner's own
plan here, not left for `_heal_plan_drift` to fix on the new owner's next
GET /workspaces. Every reconciler is keyed on owner_id, so a workspace
left on the outgoing owner's plan kept that plan's limits after they
cancelled — for as long as the new owner never loaded the list. Anything
the new plan doesn't include is paused the same way a downgrade does it.

## Path parameters

- `workspace_id` string, required

## Request body

- TransferOwnership
  - `new_owner_id` string, required

## Response `200`

Successful Response

- RoutersWorkspacesWorkspaceOut
  - `id` string, required
  - `name` string, required
  - `slug` string, required
  - `owner_id` string, required
  - `plan` 'starter' | 'influencer' | 'creator', required
  - `personal` boolean, required
  - `name_is_custom` boolean, required
  - `avatar_url` string, nullable, required
  - `hook_photo_url` string, nullable, required
  - `created_at` string, date-time, required
  - `role` 'owner' | 'admin' | 'member', required
  - `teams_enabled` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reeldrop/apis/reeldrop-api.md) · [All operations](https://skmtc.dev/reeldrop/apis/reeldrop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reeldrop/apis/reeldrop-api/revisions/d3b2a338556c?raw)