Groups
Team platform

List groups

Retrieves a list of workspace groups, sorted by their creation date in descending order (most recent entries first).

Scopes required:

  • groups:read
get/v1/groups

Request

  • Base URL: https://public-api.tryriot.com
  • URL: https://public-api.tryriot.com/v1/groups
  • Auth: API key in header x-api-key

Query parameters

cursorstring

Pagination cursor for retrieving the next page of results. This value is obtained from the 'x-next-cursor' response header of a previous API call. The cursor should be passed unchanged to fetch next pages. See https://docs.tryriot.com/api-reference/introduction#pagination for examples.

limitinteger

Maximum number of items to return. Maximum value is 100.

workspace_idstring uuid required

ID of the workspace for which to retrieve groups

Headers

x-item-limitinteger

Maximum number of items to return. Maximum value is 100.

x-next-cursorstring

Pagination cursor for retrieving the next page of results. This value is obtained from the 'x-next-cursor' response header of a previous API call. The cursor should be passed unchanged to fetch next pages. See https://docs.tryriot.com/api-reference/introduction#pagination for examples.

Response

Groups list

Example response

{
  "data": [
    {
      "name": "Marketing Team"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.