List units and sections

List the units and sections your account can reach, with their ids.

GET https://cotlet.dev/api/v1/quinyx/groups

read

Returns each group with its id, name, type and parent. Type is unit, section or a higher level, and the ids are what the other tools take as group_id. Shifts and absences can be added to units and sections only. The list follows the groups your roles reach in the group selector.

Parameters

Parameters: list_groups
NameTypeDescription
query string string Part of a unit or section name.

Request

cURL
curl https://cotlet.dev/api/v1/quinyx/groups \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("quinyx", "list_groups")
Node.js
const result = await cotlet.call('quinyx', 'list_groups');
CLI
cotlet call quinyx list_groups

Example response

JSON

{
  "groups": [
    {
      "group_id": "1042",
      "name": "Harbor Cafe",
      "type": "unit",
      "parent_id": "1001"
    },
    {
      "group_id": "1043",
      "name": "Harbor Cafe Kitchen",
      "type": "section",
      "parent_id": "1042"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.