28 March 2025

Production release: 28 March 2025

28 March 2025

Enhancements

• New version (v2) of the API available

Note: The existing version of the API will continue to be supported until at least mid-2026; however, moving forward, all new features and enhancements will be in the v2 API.

Changes in the new API

New Endpoints

• Stage: https://cloud.stage.api.trimblecloud.com/fileservice/api/2.0
• Production: https://cloud.api.trimble.com/fileservice/api/2.0

Redefined Permission Model

• Introduced the inherits field to manage permission inheritance explicitly.

• Deprecated the acl field and added new fields to provide a more comprehensive view of access rights.

• Replaced acl with:

  • permissionsLocal: permissions set directly on the resource
  • permissionsInherited: permissions inherited from parents
  • permissionsEvaluated: the actual permissions of the resource

• Added the field capabilities which specifies the actions the current user can perform on the resource.

Enhanced Asynchronous API Responses

In v1, asynchronous operations (e.g., deleting a folder and its children), returned information about the asynchronous job. In v2, asynchronous operations return:

• The updated resource in the response body.
• A Location header pointing to the associated job status.
• An HTTP 202 status code.

These enhanced responses apply to the following endpoints: Space (Delete, Restore), Folders (Rename, Move, Restore, Delete, Copy), and Files (Delete, Restore).

TRN v2 Representation for Fileservice Entities

File Service resource identifiers such as id, parentId, and spaceId, now include additional corresponding fields in the TRN v2 format, ensuring a standardized and structured representation across API responses.