quipteams API
GET/roles
scoperoles:readreturns200

List roles

Returns roles for your company with keyset cursor pagination. List rows carry `kit_ids`. Read a single role for kit names.

Query parameters

search
stringFilter by role name.
sort
stringOne of: created_at, updated_at, name. Prefix with `-` for descending. Default `-created_at`. Unknown fields return 400 VALIDATION_ERROR.
limit
numberRows per page. Default 25, max 100.
cursor
stringOpaque keyset cursor - pass `meta.next_cursor` from the previous page.

Example response

json
{
  "data": [
    {
      "id": "3c4d5e6f-7a8b-4910-a1b2-c3d4e5f60718",
      "name": "Engineer",
      "kit_ids": ["7a8b9c0d-1e2f-4304-9516-273849a5b6c7"],
      "created_at": "2026-01-05T00:00:00.000Z",
      "updated_at": "2026-01-05T00:00:00.000Z"
    }
  ],
  "meta": { "has_more": false, "next_cursor": null, "total": 1 }
}