<access-service>/api/v1/organisations/{orgId}/groups/{groupId}/labels

URL structure

https://access-service.xy-company.com/api/v1/organisations/{orgId}/groups/{groupId}/labels

where {orgId} is the ID of an organisation and {groupId} is the ID of one of this organisation's clearances.

Supported methods and overview

• GET - retrieves a list of information for all classifications that are currently associated with a clearance (specified by groupId) in an organisation (specified by orgId).

Note: This method takes no parameters.

Detailed description

This API endpoint retrieves a list of information for all classifications that are currently associated with a clearance (specified by groupId) in an organisation (specified by orgId).

A clearance's ID can be obtained by calling the GET method of the <access-service>/api/v1/organisations/{orgId}/groups API endpoint, which retrieves a list of information for all clearances in the organisation (specified by orgId).

Supported roles and conditions

This API endpoint supports requests utilizing Cocoon Data user accounts with the following roles (as described in the Organisation Administrator's Guide) and conditions:

• Organisation administrator - if this user is a member of the organisation specified by {orgId} in the request's URL.

The Cocoon Data Platform's resources available to one of these Cocoon Data users (above) is determined by the access token submitted in the header of requests to this endpoint.

Required headers

The appropriate access token as the Bearer token:

• Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE0NjcwMTY2NjYsInVzZXJfbmFtZSI6ImFsZXgub...

Returns

A JSON-formatted response containing the following members:

• items - .
• id - .
• name - .
• priority - .
• applyI18n - .
• count - .

• offset - .

  Example (response):

  {
      "items": [{
          "id": "766862496543055872",
          "name": {
              "value": "Unclassified"
          },
          "priority": "3",
          "applyI18n": false
      }, {
          "id": "766860228984872960",
          "name": {
              "value": "Restricted/Protected"
          },
          "priority": "2",
          "applyI18n": false
      }],
      "count": "2",
      "offset": "0"
  }