INinfomaniak
Drive > Files > Share link > Manage

Update share-link

Changed on

Update a share-link

put/2/drive/{drive_id}/files/{file_id}/link

Request

  • Base URL
    https://api.infomaniak.com
  • URL
    https://api.infomaniak.com/2/drive/{drive_id}/files/{file_id}/link
  • Auth
    HTTP bearer

Path parameters

drive_idinteger required

Drive identifier

file_idinteger required

File identifier

Request body

can_commentboolean

Allow users to to comment the shared files. It takes the same value as can_edit if unset or null

can_downloadboolean

Allow users to download shared content

can_editboolean

Allow users to edit the file content using the shared link

can_request_accessboolean

Allow connected users to join the folder via the shared link. It is not possible to join a file via a shared link

can_see_infoboolean

Allow users to see information about the shared files

can_see_statsboolean

Allow users to see statistics

passwordstring

The password if the permission password is set

right'password' | 'public'

Permission of the shared link: no restriction (public) or public but protected by a password (password)

valid_untilinteger nullable

Maximum validity timestamp of the shared link

Response

OK

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

Result of the HTTP request

databoolean

Example response

{
  "result": "success"
}

Changes

  • e6daf54dcb44Revision changes
    • warning

      added the new forbidden_error enum value to the // response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 970770257c30Revision changes
    • breaking

      removed the enum value inherit of the request property