Groups

List groups

Retrieves all groups owned by the current user.

get/groups

Query parameters

ownerstring email

The owner's email.

type'domain' | 'list'
sort'created' | 'name' | 'type'

Sort criteria.

order'asc' | 'desc'
limitinteger
offsetinteger

Response

A paginated list of groups.

Changes

Changed in 6 of the 14 revisions of this API.4810

    • for the query request parameter owner, the type/format was changed from string/ulid to string/email

      request-parameter-type-changed

    • added the new optional query request parameter owner

      new-optional-request-parameter

    • added the new optional query request parameter type

      new-optional-request-parameter

    • the data/items/domain response's property type/format changed from string/hostname to string/fqdn for status 200

      response-property-type-changed

  • 29160670a92916See the full diff
    • the response's body type/format changed from array/ to object/ for status 200

      response-body-type-changed

    • added the new optional query request parameter limit

      new-optional-request-parameter

    • added the new optional query request parameter offset

      new-optional-request-parameter

    • added the new optional query request parameter order

      new-optional-request-parameter

    • added the new optional query request parameter sort

      new-optional-request-parameter

    • added the optional property data to the response with the 200 status

      response-optional-property-added

    • added the optional property pagination to the response with the 200 status

      response-optional-property-added

    • added the optional property items/domain to the response with the 200 status

      response-optional-property-added

    • added the optional property items/members to the response with the 200 status

      response-optional-property-added

  • 0d7f3c75097918See the full diff
    • the response's body type/format changed from object/ to array/ for status 200

      response-body-type-changed

    • deleted the query request parameter limit

      request-parameter-removed

    • deleted the query request parameter offset

      request-parameter-removed

    • deleted the query request parameter order

      request-parameter-removed

    • deleted the query request parameter owner

      request-parameter-removed

    • deleted the query request parameter sort

      request-parameter-removed

    • deleted the query request parameter type

      request-parameter-removed

    • removed the optional property data from the response with the 200 status

      response-optional-property-removed

    • removed the optional property pagination from the response with the 200 status

      response-optional-property-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog