Modify a volume members' permissions

This call modifies 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 does not overwrite all previously set permissions for the member. Refer to the request to overwrite a volume members' permissions to overwrite rather than update permissions.

Request

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

Example request

PATCH /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 PATCH "https://api.sb.biodatacatalyst.nhlbi.nih.gov/storage/volumes/rfranklin/my-first-volume/members/{username}/permissions"

Header Fields

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

Path parameters

Key	Data type of value	Description of value
`volume_id` required	String	The volume that you want to query, which consists of username of the volume owner and volume name, for example `rfranklin/my-first-volume`.
`username`	String	Enter 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.

Key	Data type	Description
`read`	String	Set 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.
`copy`	String	Set 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.
`write`	String	Set 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.
`admin`	String	Set this to `true` to grant admin permissions or `false` to remove them.

Example request body

{
  "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
}