Drive > Files > File/Directory > Access

Check access change

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.

post/2/drive/{drive_id}/files/{file_id}/access/check

Path parameters

drive_idinteger required

Drive identifier

file_idinteger required

File identifier

Request body

emailsstring[]
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_idsinteger[]
user_idsinteger[]

Example request

{
  "right": "manage"
}

Response

OK

result'success' | 'error' | 'asynchronous' required

Result of the HTTP request

Example response

{
  "result": "success",
  "data": [
    {
      "user_id": 1000,
      "current_right": "manage",
      "message": "error_already_exist"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.