API Documentation
<content-service>/api/v1/users/me

URL structure

https://content-service.xy-company.com/api/v1/users/me

Supported methods and overview

  • GET - used to retrieve the total storage (managed by the Covata Platform's Content Service) which has been utilized by the currently authenticated Covata user*.

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 the currently authenticated 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):

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 the currently authenticated 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"
    }
    }

* The currently authenticated user is determined by the access token passed in the header of requests to this endpoint.