API Documentation
Toggle TOC panel
<access-service>/api/v1/userwhitelist/bulk

URL structure

1 https://access-service.xy-company.com/api/v1/userwhitelist/bulk

Supported methods and overview

  • POST ( Deprecated ) - deletes one or more existing user whitelist rule/s (specified by their IDs in the body of the request) of any organisation, in a single action (available to SafeShare administrators only).

Note: This endpoint is deprecated and should no longer be used. Organisation administrators can delete existing user whitelist rules by calling the DELETE method on the <access-service>/api/v1/organisations/{orgId}/userwhitelist/{whitelistId} API endpoint.

Detailed description

This API endpoint deletes one or more existing user whitelist rule/s (specified by their IDs in the body of the request) of any organisation, in a single action (available to SafeShare administrators only).

It is possible to check which existing Cocoon Data user accounts will be affected (i.e. regain the ability to be shared content) by calling the <access-service>/api/v1/organisations/{orgId}/userwhitelist/check API endpoint with an action parameter value of delete in the JSON object, along with the ids (i.e. of each whitelist rule to be deleted) in the items array.

Organisation administrators can delete a single user whitelist rule by calling the DELETE method of the <access-service>/api/v1/organisations/{orgId}/userwhitelist/{whitelistId} API endpoint.

Deleting the last user whitelist rule in an organisation results in the user whitelist feature being disabled for that organisation.

Supported roles

This API endpoint supports the following Cocoon Data user roles (as described in the SafeShare Administrator's Guide):

The Cocoon Data Platform's resources available to a Cocoon Data user meeting the criteria 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...

The following header is required if the body of the request has a JSON object:

  • Content-Type: application/json

Required parameters

The following required parameter must be sent in the URL of the POST request:

  • action - The enumeration (enum) value delete.
    Example (request URL):
    1 https://access-service.xy-company.com/api/v1/userwhitelist/bulk?action=delete

The following required parameter must also be sent in the body of the POST request, as an individual member of a JSON object:

  • ids - An array of IDs of individual user whitelist rules to be deleted.
    Example (request body):
    {
    "ids": [765456269464346624, 765708906118029312]
    }

Returns

If the request succeeded, then an HTTP response status 200 OK is returned.