Skip to main content

​
URL structure

where {orgId} is the ID of an organization.

​
Supported methods and overview

  • POST - used to add a new group to an organization.
  • GET - used to retrieve a list of information for all groups defined within an organization.

​
Detailed description

This API endpoint serves a number of purposes:

​
Supported roles

This API endpoint supports requests utilizing Covata user accounts with the following roles (as described in the Organization Administrator’s Guide) and conditions: The Covata Platform’s resources available to one of these Covata users (above) is determined by the access token passed in the header of requests to this endpoint.

​
Required headers

The appropriate access token as the Bearer token:
  • Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE0NjcwMTY2NjYsInVzZXJfbmFtZSI6ImFsZXgub...
The following header is required if the body of the request has a JSON object:
  • Content-Type: application/json

​
Required parameters on POST

The following required parameter must be sent in the body of the POST request, as an individual member of a JSON object:
  • name - . Example ():

​
Optional parameters on POST

The following optional parameter can also be sent in the body of the POST request, as an individual member of the JSON object that includes the Required parameters on POST above:
  • description - . Example ():

​
Optional parameters on GET

The following optional parameters can be sent in the URL of the GET request:
  • limit - 0 to 100 (default is 0).
  • offset - default is 0.
  • orderBy - ASC or DESC (default is ASC).
  • sortBy - . Example ():

​
Returns from a POST request

A JSON-formatted response containing the following members:
  • id - .
  • name - .
  • description - . Example (response from …):

​
Returns from a GET request

A JSON-formatted response containing the following members:
  • items - .
    • id - .
    • name - .
    • labelCount - .
    • memberCount - .
  • count - .
  • offset - . Example (response from …):