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

# Creates a grant access request.

`POST /api/v1/Requests/GrantAccess`

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

- CreateGrantAccessRequestRequestV1 — Request to create a new grant access request.
  - `createdByUserId` string, uuid, required — User that appears as creator of the request.
  - `targetUserId` string, uuid, required — Identifier of the user who will receive access.
  - `workAppId` string, uuid, required — Identifier of the work app for which access is being requested.
  - `grantAccessPurpose` string, required — Purpose or reason for the grant access request.
  - `permissionLevelId` string, uuid, nullable — Optional identifier of the permission level to request. It is mandatory if the work app has at least one permission level.

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