modify_shared_link_settings
POST https://api.dropboxapi.com/2/sharing/modify_shared_link_settings
scope: sharing.write
Modify the shared link's settings.
If the requested visibility conflict with the shared links policy of the team or the shared folder (in case the linked file is part of a shared folder) then the LinkPermissions.resolved_visibility of the returned SharedLinkMetadata will reflect the actual visibility of the shared link and the LinkPermissions.requested_visibility will reflect the requested visibility.
Request Body
{"url"=>"https://www.dropbox.com/s/2sn712vy1ovegw8/Prime_Numbers.txt?dl=0", "settings"=>{"requested_visibility"=>"public", "audience"=>"public", "access"=>"viewer"}, "remove_expiration"=>false}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Dropbox-API-Path-Root | string | ||
Dropbox-API-Select-User | string |
RESPONSES
status: OK
{".tag":"file","url":"https://www.dropbox.com/s/2sn712vy1ovegw8/Prime_Numbers.txt?dl=0","name":"Prime_Numbers.txt","link_permissions":{"can_revoke":false,"resolved_visibility":{".tag":"public"},"revoke_failure_reason":{".tag":"owner_only"}},"client_modified":"2015-05-12T15:50:38Z","server_modified":"2015-05-12T15:50:38Z","rev":"a1c10ce0dd78","size":7212,"id":"id:a4ayc_80_OEAAAAAAAAAXw","path_lower":"/homework/math/prime_numbers.txt","team_member_info":{"team_info":{"id":"dbtid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I","name":"Acme, Inc."},"display_name":"Roger Rabbit","member_id":"dbmid:abcd1234"}}