---
title: "POST /requests/{id}/deny"
method: POST
path: "/requests/{id}/deny"
tags: ["requests"]
---

# POST /requests/{id}/deny

`POST /requests/{id}/deny`

Deny an access request

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `comment` string, required — Comment for the denial
  - `level` 'REGULAR' | 'ADMIN' — The decision level for the approval

## Response `200`

Request successfully denied

- object
  - `request` Request — # Request Object ### Description The `Request` object is used to represent a request. ### Usage Example Returned from the `GET Requests` endpoint.
    - `id` string, uuid, required — The unique identifier of the request.
    - `created_at` string, date-time, required — The date and time the request was created.
    - `updated_at` string, date-time, required — The date and time the request was last updated.
    - `requester_id` string, uuid, required — The unique identifier of the user who created the request.
    - `target_user_id` string, uuid — The unique identifier of the user who is the target of the request.
    - `target_group_id` string, uuid — The unique identifier of the group who is the target of the request.
    - `status` 'PENDING' | 'APPROVED' | 'DENIED' | 'CANCELED', required — # Request Status ### Description The `RequestStatus` enum is used to represent the status of a request. ### Usage Example Returned from the `GET Requests` endpoint.
    - `reason` string, required — The reason for the request.
    - `duration_minutes` integer — The duration of the request in minutes.
    - `requested_items_list` RequestedItem[] — The list of targets for the request.
      - `resource_id` string, uuid — The ID of the resource requested.
      - `group_id` string, uuid — The ID of the group requested.
      - `access_level_name` string — The name of the access level requested.
      - `access_level_remote_id` string — The ID of the access level requested on the remote system.
      - `name` string — The name of the target.
      - `remote_id` string — The ID of the target on the remote system.
      - `remote_name` string — The name of the target on the remote system.
    - `custom_fields_responses` RequestCustomFieldResponse[] — The responses given to the custom fields associated to the request
      - `field_name` string, required
      - `field_type` 'SHORT_TEXT' | 'LONG_TEXT' | 'BOOLEAN' | 'MULTI_CHOICE', required — The type of the custom request field.
      - `field_value` union, required
        - string
        - boolean
    - `stages` RequestItemStages — The stages configuration for a request item
      - `requestedRoleName` string — The name of the requested role
      - `requestedItemName` string, required — The name of the requested item
      - `stages` RequestStage[], required — The stages of review for this request
        - `stage` integer, required — The stage number
        - `operator` 'AND' | 'OR', required — The operator to apply to reviewers in a stage
        - `reviewers` RequestReviewer[], required — The reviewers for this stage
          - `id` string, uuid, required — The unique identifier of the reviewer
          - `full_name` string — The user's full name.
          - `status` 'PENDING' | 'APPROVED' | 'REJECTED', required — The status of this reviewer's review
    - `reviewer_stages` union — The configured reviewer stages for every item in this request, or an error message if reviewers could not be loaded
      - RequestReviewerStages[]
        - `access_level_name` string — The name of the access level requested.
        - `access_level_remote_id` string — The ID of the access level requested on the remote system.
        - `item_name` string, required — The name of the requested item
        - `item_id` string, uuid, required — The ID of the resource requested.
        - `stages` RequestStage[], required — The stages of review for this request
          - `stage` integer, required — The stage number
          - `operator` 'AND' | 'OR', required — The operator to apply to reviewers in a stage
          - `reviewers` RequestReviewer[], required — The reviewers for this stage
            - `id` string, uuid, required — The unique identifier of the reviewer
            - `full_name` string — The user's full name.
            - `status` 'PENDING' | 'APPROVED' | 'REJECTED', required — The status of this reviewer's review
      - string

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/versions/13b58df96d40/schema)