---
title: "Transfer ownerships of the workspaces"
method: PATCH
path: "/settings/users"
tags: ["Owner user control settings"]
---

# Transfer ownerships of the workspaces

`PATCH /settings/users`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/settings/users`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Transfer ownerships of the workspaces

## Request body

- WorkspaceUsersSettingsPatch: Transfer ownership of workspaces
  - `patches` WorkspaceUsersSettingsPatchOp[], required
    - `op` 'replace', required: Operation to be performed
    - `path` 'role', required: Operation path
    - `value` TransferOwnership, required: Transfer ownership details
      - `workspace_id` integer, required: Workspace id
      - `user_id` integer, required: User id
      - `new_role` 'workspace_member' | 'workspace_admin' | 'workspace_owner' | 'workspace_guest': New role name
      - `remove_role` 'workspace_member' | 'workspace_admin' | 'workspace_owner' | 'workspace_guest' | 'null', nullable: Remove role name

## Response `200`

Request fulfilled, document follows

- object

## Other responses

- `400`: Bad request syntax or unsupported method

---

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