GET group/…/staff

Retrieves the staff permissions for a group.

Resource URL

https://www.drillster.com/api/2.1/group/{group_id}/staff

The group ID is the unique identifier of the group.

Parameters

Field Type Description
groupId
required
String The ID of the group.

Response

A 2.1 GroupStaff object detailing the individual staff permissions for the group.

Example request

GET https://www.drillster.com/api/2.1/group/pX3rn8LnXn5QM3mzwmSXDnDYeDpsnIqsHoXEKN2N3_B/staff

Response

{
  "group": {
    "id": "pX3rn8LnXn5QM3mzwmSXDnDYeDpsnIqsHoXEKN2N3_B"
  },
  "count": 1,
  "groupStaffUsers": [ {
    "group": {
      "id": "pX3rn8LnXn5QM3mzwmSXDnDYeDpsnIqsHoXEKN2N3_B"
    },
    "user": {
      "type": "USER",
      "id": "m3XfGV1LQhu729lfVYa_sQ",
      "name": "Jane Doe",
      "avatar": {
        "type": "image/png",
        "url": "https://www.drillster.com/bin/avatar/330b901c200be68b852885e3a7eb31f7e938f29d"
      },
      "locale": "nl"
    },
    "permission": "MANAGE"
  } ]
}

Error responses

The following error situations are possible:

ID Description
not_permitted User is not entitled to view details for requested group.
unknown_group Given group is unknown.