---
title: "Transfer document ownership"
method: PUT
path: "/api/v1/documents/{identifier}/transfer-ownership"
tags: ["Documents"]
deprecated: true
---

# Transfer document ownership

`PUT /api/v1/documents/{identifier}/transfer-ownership`

> **Deprecated.**

Deprecated. Ownership is a content role: grant a user the OWNER role via the permissions endpoint instead. This endpoint grants OWNER to the named user and demotes every other user holding OWNER on the document itself to MANAGER. Ownership inherited from an ancestor folder is untouched.

## Path parameters

- `identifier` string, required — Document identifier (either document ID or identifier slug)

## Request body

- DocumentsTransferOwnershipBody
  - `userId` string, uuid, required — Membership ID of the new owner

## Response `200`

Ownership transferred successfully

- SuccessResponse
  - `success` boolean, required — Whether the operation was successful

## Other responses

- `400` — Invalid user ID
- `401` — Authentication required
- `403` — Permission denied - MANAGER role or owner required
- `404` — Document or user not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/revisions/e77ab32034c9/schema)