List data release permissions
List the users who have read or write access to a data release.
Returns the current membership of the release's Globus permission groups as a list of permission assignments, each pairing a Globus username with the read or write permission that user holds:
- read → members of the release's read-only (R) group, who may view the release and its files.
- write → members of the release's read-write (RW) group, who may view and modify the release and its files.
The response is a flat list; a user who belongs to both groups appears once per permission level.
.. code-block::
[
{"globus_username": "user1@example.org", "permission": "read"},
{"globus_username": "user2@example.org", "permission": "write"}
]
The caller must have an existing role on the release; otherwise a 403 Forbidden is returned.
Note: permissions are read from the release's Globus groups directly. Publishing a release removes these groups, so this endpoint is intended for releases that have not yet been published.
:param id: The ID of the data release whose permissions to list. :param token: A valid bearer token for the user making the request. :raises ForbiddenException: If the caller has no role on the release. :raises NotFoundException: If no data release exists for the given ID. :return: The active read and write members of the release.
Request
- Base URLhttps://data.usgs.gov (the document declares no server; this is the origin it was published from)
- AuthOAuth 2Authorization code: https://auth.globus.org/v2/oauth2/authorize?scope=openidToken URL: https://data.usgs.gov/datacatalog/api/auth/login
Path parameters
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.