---
title: "Creates a remove access request."
method: POST
path: "/api/v1/Requests/RemoveAccess"
tags: ["Requests"]
---

# Creates a remove access request.

`POST /api/v1/Requests/RemoveAccess`

## 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

- CreateRemoveAccessRequestRequestV1 — Request to create a new remove access request.
  - `createdByUserId` string, uuid, required — User that appears as creator of the request.
  - `targetUserId` string, uuid, required — Identifier of the user who will lose access.
  - `workAppId` string, uuid, required — Identifier of the work app for which access is being removed.
  - `removeAccessPurpose` string, required — Purpose or reason for the remove access request.

## 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
- `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)