List members of a volume

This call returns the members 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).

Request

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

Example request

GET /v2/storage/volumes/rfranklin/my-first-volume/members 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 GET "https://api.sb.biodatacatalyst.nhlbi.nih.gov/storage/volumes/rfranklin/my-first-volume/members"

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.

Response

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

Example response body

{
    "username": "crickwatson",
    "email": "[email protected]",
    "permissions": {
      "read": true,
      "write": true,
      "copy": true,
      "admin": true
    },
    "joined_on": 1495107052,
    "level": "USER"
  },
  {
    "username": "rfranklin",
    "email": "[email protected]",
    "permissions": {
      "read": false,
      "write": true,
      "copy": true,
      "admin": false
    },
    "joined_on": 1495629139,
    "level": "USER"
  }

Interpreting the response body

Volume members have the following permissions:

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.