Document new share attributes and the "download" permission

[PVince81]

Ref nextcloud/server#32482

curl -u admin:admin 'https://domain.tld/ocs/v2.php/apps/files_sharing/api/v1/shares/$shareId` \
  -X 'PUT' \
  -H 'OCS-APIRequest: true' \
-H 'Accept: application/json, text/plain, */*' \
  -H 'Content-Type: application/json' \
  --data-raw '{"attributes":[{"scope": "permissions", "key": "download", "enabled": "false"}]}'

[PVince81]

PR here: #9518

[xeruf]

Is there any way to create a link with this attribute set via curl and not have to make a separate PUT request?
Checked the docs but got nothing the like to work:

curl ... -X POST -d 'path=/DIR&shareType=3&permissions=1&publicAccess=1&expireDate=2023-04-15&attributes=[{"scope":"permissions","key":"download","enabled":false}]'

https://docs.nextcloud.com/server/stable/developer_manual/client_apis/OCS/ocs-share-api.html#share-attributes

[xeruf]

Not even working with what you posted :/

❯ curl -u admin:PWD 'https://DOMAIN/ocs/v2.php/apps/files_sharing/api/v1/shares/ID' -X 'PUT' -H 'OCS-APIRequest: true' -H 'Accept: application/json, text/plain, */*' -H 'Content-Type: application/json' --data-raw '{"attributes":[{"scope": "permissions", "key": "download", "enabled": "false"}]}'
<?xml version="1.0"?>
<ocs>
 <meta>
  <status>failure</status>
  <statuscode>500</statuscode>
  <message>Internal Server Error
OCA\Files_Sharing\Controller\ShareAPIController::updateShare(): Argument #10 ($attributes) must be of type ?string, array given, called in /var/www/html/lib/private/AppFramework/Http/Dispatcher.php on line 225 in file '/var/www/html/apps/files_sharing/lib/Controller/ShareAPIController.php' line 1069</message>
 </meta>
 <data/>
</ocs>