---
title: "Move the people of a permission set to another permission set"
method: PATCH
path: "/api/v2/roles/{id}/transfer_people"
tags: ["Permission Sets"]
---

# Move the people of a permission set to another permission set

`PATCH /api/v2/roles/{id}/transfer_people`

## Request

- Base URL: `https://developer.productive.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.productive.io/api/v2/roles/{id}/transfer_people`
- Auth: none declared

## Path parameters

- `id` string, required

## Request body

- object
  - `target_role_id` integer, required

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `406`: Not Acceptable
- `408`: Request Timeout
- `415`: Unsupported Media Type
- `422`: Unprocessable Content
- `423`: Locked
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-11-02** `fa3060fd0144`: 3 warning, 10 info
  - added the new `bad_decimal_format` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `non_finite_number` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `null_bytes_in_params` enum value to the `errors/items/code` response property for the response status `422`
  - added the non-success response with the status `400`
  - …9 more

[Operation history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/roles/:id/transfer_people/patch.md)

---

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