Overwrite a volume members' permissions

This call overwrites the permissions for a member of a specific volume. The volume is specified as volume_id and consists of the owner and name of a volume (for example rfranklin/my-first-volume).

Note that this overwrites all previously set permissions for the member. Refer to the request to modify a volume member's permissionsto update rather than overwrite permissions.

Request

https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2/storage/volumes/{volume_id}/members/{username}/permissions

Example request

PUT /v2/storage/volumes/rfranklin/my-first-volume/members/{username}/permissions HTTP/1.1
Host: api.sb.biodatacatalyst.nhlbi.nih.gov
X-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f75
curl  -s -H "X-SBG-Auth-Token: 6282d5e2121d43e7900e9d52b15845e7" -H "Content-type: application/json" -X PUT "https://api.sb.biodatacatalyst.nhlbi.nih.gov/storage/volumes/rfranklin/my-first-volume/members/{username}/permissions"

Header Fields

KeyDescription of value
X-SBG-Auth-Token
required
Your authentication token.
Content-type
required
application/json

Path parameters

KeyData type of valueDescription of value
volume_id
required
StringThe volume that you want to query, which consists of username of the volume owner and volume name, for example rfranklin/my-first-volume.
usernameStringEnter the username of the collaborator whose permissions you'd like to overwrite.

Request body

In the body, you should enter a list of key-value pairs. The keys and the values they take are described in the following table.

KeyData typeDescription
readStringSet this to true to grant read permissions or false to remove them. read permissions allow a volume member to browse the contents of the volume.
copyStringSet this to true to grant copy permissions or false to remove them. copy permissions allow a volume member to import the contents of the volume to the Platform.
writeStringSet this to true to grant write permissions or false to remove them. write permissions allow a volume member to export files from the Platform to the volume.
adminStringSet this to true to grant admin permissions or false to remove them.

Example request body

{
  "write": false,
  "read": true,
  "copy": false,
  "admin": true
}

Response

See a list of response codes that may be contained in the body of the response.

Example response body

{
  "write": false,
  "read": true,
  "copy": false,
  "admin": true
}