---
title: "Creates a change permission request."
method: POST
path: "/api/v1/Requests/ChangePermission"
tags: ["Requests"]
---

# Creates a change permission request.

`POST /api/v1/Requests/ChangePermission`

## Headers

- `X-API-SECRET` string, required — API Secret is used to verify the integrity of the request and authenticate the client. It should be included in all requests. This value must be kept confidential and should never be exposed in client-side code or public repositories.

## Request body

- CreateChangePermissionRequestRequestV1 — Request to create a new change permission request.
  - `createdByUserId` string, uuid, required — User that appears as creator of the request.
  - `targetUserId` string, uuid, required — Identifier of the user for which permission level is being changed.
  - `workAppId` string, uuid, required — Identifier of the work app for which permission level is being changed.
  - `changePermissionPurpose` string, required — Purpose or reason for the change permission request.
  - `permissionLevelId` string, uuid, required — The new permission level for the user

## Response `201`

Created

- CreatedRequestResultViewModelV1 — Result of a successful request creation.
  - `requestId` string, required — Unique identifier of the created request.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `500` — Internal Server Error

---

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