---
title: "Grant an access request"
method: POST
path: "/api/v1/access_requests/{access_request_id}/grant"
tags: ["access_requests"]
---

# Grant an access request

`POST /api/v1/access_requests/{access_request_id}/grant`

Grants a (pending, fully approved) access request.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Response `200`

Access request granted

- AccessRequest — An access request
  - `application_id` string, uuid, required — Application ID
  - `duration` string, nullable — Duration of time-based access as an ISO 8601 duration (e.g. "PT1H", "P7D"); null for permanent access
  - `expires_at` string, date-time, nullable — When the time-based access expires; null for permanent access or a time-based request that has not been granted yet
  - `grantee_user_id` string, uuid — User ID of the grantee
  - `id` string, uuid, required — Access request ID
  - `inserted_at` string, date-time — Creation timestamp
  - `permission_ids` string[], required — Requested permission IDs
  - `provisioning_type` 'application_admin' | 'automatic', nullable — Provisioning type
  - `request_reason` string, required — Request reason
  - `requestor_user_id` string, uuid — User ID of the requestor
  - `resource_id` string, uuid, required — Resource ID
  - `status` 'pending_approval' | 'pending_permissions_assignment' | 'access_granted' | 'denied' | 'rejected' | 'processing_access' | 'scheduled' | 'pending_dependency', required — Current status of the access request

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Validation error

---

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