Sign in
Groups

Create group

Creates a new user group with the current user as the owner.

post/groups

Request body

namestring required
descriptionstring nullable
type'domain' | 'list' required
domainstring fqdn

Required if type is 'domain'.

membersstring[]

Array of user emails. Only applicable if type is 'list'.

Response

Group created successfully.

idstring ulid required
ownerstring ulid required
namestring required
descriptionstring nullable
type'domain' | 'list' required
domainstring fqdn

Present if type is 'domain'.

membersstring[]

Array of user emails. Present if type is 'list'.

Changes

Changed in 3 of the 14 revisions of this API.346

  • 9aec27988ad321See the full diff
    • ▲

      the domain request property type/format changed from string/hostname to string/fqdn

      request-property-type-changed

    • ▲

      the domain response's property type/format changed from string/hostname to string/fqdn for status 201

      response-property-type-changed

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

  • 128cf3db212c13See the full diff
    • ●

      removed the request property users

      request-property-removed

    • ○

      added the new optional request property members

      new-optional-request-property

    • ○

      added the optional property domain to the response with the 201 status

      response-optional-property-added

    • ○

      added the optional property members to the response with the 201 status

      response-optional-property-added

  • 0d7f3c750979132See the full diff
    • ▲

      the domain request property type/format changed from string/fqdn to string/hostname

      request-property-type-changed

    • ●

      removed the request property members

      request-property-removed

    • ●

      removed the optional property domain from the response with the 201 status

      response-optional-property-removed

    • ●

      removed the optional property members from the response with the 201 status

      response-optional-property-removed

    • ○

      added the new optional request property users

      new-optional-request-property

    • ○

      removed the non-success response with the status 404

      response-non-success-status-removed

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