POST /Requests/ChangePermission

Creates a change permission request.

post

Authorizations

API Key

X-API-KEYstringRequired

Public API key used to identify the client application. It should be included in all requests.

Header parameters

X-API-SECRETstringRequired

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.

Example: YOUR_API_SECRET

Body

application/jsontext/jsonapplication/*+json

Request to create a new change permission request.

createdByUserIdstring · uuidRequired

User that appears as creator of the request.

targetUserIdstring · uuidRequired

Identifier of the user for which permission level is being changed.

workAppIdstring · uuidRequired

Identifier of the work app for which permission level is being changed.

changePermissionPurposestring · min: 1 · max: 1024Required

Purpose or reason for the change permission request.

permissionLevelIdstring · uuidRequired

The new permission level for the user

Responses

201

Created

text/plainapplication/jsontext/json

Result of a successful request creation.

requestIdstring · min: 1Required

Unique identifier of the created request.

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

409

Conflict

text/plainapplication/jsontext/json

500

Internal Server Error

post/api/v1/Requests/ChangePermission

HTTPcURLJavaScriptPython

POST /api/v1/Requests/ChangePermission HTTP/1.1
Host: open-api.getcakewalk.io
X-API-KEY: YOUR_API_KEY
X-API-SECRET: YOUR_API_SECRET
Content-Type: application/json
Accept: */*
Content-Length: 255

{
  "createdByUserId": "123e4567-e89b-12d3-a456-426614174000",
  "targetUserId": "123e4567-e89b-12d3-a456-426614174000",
  "workAppId": "123e4567-e89b-12d3-a456-426614174000",
  "changePermissionPurpose": "text",
  "permissionLevelId": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

{
  "requestId": "text"
}