---
title: "Request access on user behalf"
method: POST
path: "/appCatalog/accessRequestPolicies/{idAccessRequestPolicy}/trigger"
tags: ["App Catalog"]
---

# Request access on user behalf

`POST /appCatalog/accessRequestPolicies/{idAccessRequestPolicy}/trigger`

## Request

- Base URL: `https://api.toriihq.com/v1.0`
- URL: `https://api.toriihq.com/v1.0/appCatalog/accessRequestPolicies/{idAccessRequestPolicy}/trigger`
- Auth: API key in header `Authorization`

Triggers an access request for the specified policy on behalf of the user identified by `userEmail`.<br/><br/>The policy's approval flow runs first, and its provisioning workflow runs once the request is approved.<br/><br/>For temporary access, a deprovisioning workflow runs automatically when the requested duration ends.<br/><br/>Eligibility is enforced: the request fails with 400 NOT_ELIGIBLE_FOR_POLICY if the user is not a member of the policy’s eligibility groups.<br/><br/>
<p><ul><li>Rate limit: 60 requests per minute</li></ul></p>

## Path parameters

- `idAccessRequestPolicy` integer, required

## Request body

- Model99
  - `userEmail` string, required: Request access on behalf of this user
  - `description` string: The reason the user is requesting access to the app.
  - `requestedAccessDuration` RequestedAccessDuration: Requested access duration — how long the user should have access to the app. - **Optional by default** — omit it to request permanent access. - **Required** only when the policy allows temporary access exclusively (i.e. permanent access is disabled). - **`value` above 99** is accepted only when it matches one of the policy's duration options; a custom duration is at most 99.
    - `value` integer, required
    - `unit` 'hour' | 'day' | 'week' | 'month', required

## Response `201`

Access request triggered successfully

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/toriihq/apis/torii-api-documentation.md) - [All operations](https://skmtc.dev/toriihq/apis/torii-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/toriihq/apis/torii-api-documentation/revisions/15fd1512591b?raw)