<content-service>/api/v1/plans/usage/{userid}

URL structure

https://content-service.xy-company.com/api/v1/plans/usage/{userid}

where {userId} is the ID of a Covata user.

Supported methods and overview

• GET - used to retrieve the total storage (managed by the Covata Platform's Content Service) which has been utilized by any Covata user (specified through the user's ID).

Note: This method takes no parameters.

Detailed description

This API endpoint retrieves the total number of bytes of storage (managed by the Covata Platform's Content Service) which has been utilized by a specific Covata user.

This total consists of the encrypted data of the Covata user's Secure Objects, as well as all read-only view data for this user's Secure Objects, whose file types (determined by file name extension) support the generation of read-only views.

Supported roles

This API endpoint supports the following Covata user roles (as described in the Covata Platform Administrator's Guide):

• System administrator

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 a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6

Returns

A JSON-formatted response containing the following members:

• diskStorage - A member containing information about the total storage (managed by the Covata Platform's Content Service) which has been utilized by a specific Covata user. This member contains the following sub-member:

  • total - The total amount of space (in bytes) of all Secure Objects' encrypted data in storage (managed by the Content Service).

  Example:

  {
    "diskStorage": {
      "total": "549744"
    }
  }