---
title: "Check access change"
method: POST
path: "/2/drive/{drive_id}/files/{file_id}/access/check"
tags: ["Drive > Files > File/Directory > Access"]
---

# Check access change

`POST /2/drive/{drive_id}/files/{file_id}/access/check`

Analyzes each user that has access to the drive by team, email or user identifier.
This method tries to find users for the given inputs:</br>
> The emails are parsed to user identifiers if possible.</br>
> The teams identifiers are parsed to multiple user identifiers.</br>
> The users identifiers are parsed accordingly.</br></br>
A right is required to simulate if a user needs to change their permissions to match it.

## Path parameters

- `drive_id` integer, required
- `file_id` integer, required

## Request body

- object
  - `emails` string[]
  - `right` 'manage' | 'none' | 'read' | 'write', required — Access level of {name}.<note><strong>manage</strong>: Can share, write and read the file.</note><note><strong>none</strong>: Can not act on the file.</note><note><strong>read</strong>: Can only read the file.</note><note><strong>write</strong>: Can write and read the file.</note>
  - `team_ids` integer[]
  - `user_ids` integer[]

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 91ac10ffCheckchangeaccessfeedbackresource[]
    - `user_id` integer, required — User identifier
    - `current_right` 'manage' | 'none' | 'read' | 'write', required — The current user right for the File/Directory
    - `need_change` boolean, required — If the right asked need to be applied to this user, return false if the right is the same level or not applicable.</br> <b>Note:</b> A user with limited file access don't need to change his right
    - `message` 'error' | 'user_not_connected_to_drive' | 'user_right_is_same_level' | 'user_right_need_change', required — Additional information about why the right need to be applied or not : </br>user_right_need_change: If the right need to be changed</br>user_right_is_same_level: If the right is the same level</br>user_not_connected_to_drive: If the user did not connected to the drive yet</br>error: If the right cannot be changed for other reason

## Other responses

- `403` — Forbidden
- `503` — Service Unavailable

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)