---
title: "Ask to recover ownership"
method: POST
path: "/workspace/recoveries"
tags: ["workspace"]
---

# Ask to recover ownership

`POST /workspace/recoveries`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/workspace/recoveries`
- Auth: HTTP bearer

For a workspace whose only owner can't be reached. An officer, or a director on the parties record, names a member as the new owner and passes the board consent naming them, an uploaded PDF, with a passkey. Every owner on record gets an email with the consent and can cancel for 7 days; support checks the consent against the directors on record. After both, the new owner becomes an owner and the owners on record admins.

## Request body

- object
  - `new_owner_member_id` string, required
  - `reason` string, required
  - `document_id` string, required

## Response `200`

The result.

- object
  - `id` string, required
  - `status` 'pending' | 'cancelled' | 'completed', required
  - `requested_by` string, required
  - `requested_by_member_id` string, required
  - `new_owner` string, required
  - `new_owner_member_id` string, required
  - `document_id` string, required
  - `reason` string, required
  - `notice_sent_at` string, date-time, nullable, required
  - `effective_after` string, date-time, nullable, required
  - `checked_by` string, nullable, required
  - `checked_at` string, date-time, nullable, required
  - `cancelled_by` string, nullable, required
  - `cancelled_at` string, date-time, nullable, required
  - `completed_at` string, date-time, nullable, required
  - `can_cancel` boolean, required
  - `created_at` string, date-time, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `default`: An RFC 9457 problem.

---

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