tc_files
Manage Trimble Connect files: retrieve details, versions, download URLs; check in/out, manage permissions, alignment, exports, and uploads.
Instructions
Trimble Connect Files: details, versions, download URL, check-in/out, permissions, alignment, exports, upload orchestration (JSON steps only). Select the endpoint with the "action" parameter. Path placeholders {projectId}/{id}/{subId}/{extraId}/{version} are filled from the matching input parameters. Actions:
get: GET /files/{id} — id=fileId
update: PATCH /files/{id} — id=fileId, body: {name?, parentId?...}
delete: DELETE /files/{id} — id=fileId
versions: GET /files/{id}/versions — id=fileId
versions_v21: GET /2.1/projects/{projectId}/files/{id}/versions — id=fileId (paged v2.1 API)
processing_status: GET /files/{id}/status — id=fileId
process: POST /files/{id}/process — id=fileId, body: {format:'TRB', versionId?} — trigger model assimilation/processing
download_url: GET /files/fs/{id}/downloadurl — id=fileId, query: {versionId?}
checkin: POST /files/{id}/checkin — id=fileId
checkout: POST /files/{id}/checkout — id=fileId
permissions_get: GET /files/{id}/permissions — id=fileId
permissions_update: PATCH /files/{id}/permissions — id=fileId, body: permissions
supported_formats: GET /files/formats — list supported 2D/3D/spatial formats
snapshot: GET /files/fs/snapshot — query: {projectId} — active file/folder snapshot
create_export: POST /files/export — body: export request
get_export: GET /files/export/{id} — id=exportId
initiate_upload: POST /files/fs/initiate — body: upload init request (returns signed upload URLs)
initiate_package_upload: POST /files/fs/upload — body: package upload request
complete_multipart_upload: POST /files/fs/upload/{id}/complete — id=uploadId, body: parts
commit_upload: POST /files/fs/commit — body: commit request
upload_details: GET /files/fs/upload — query: upload details params
upload_status: GET /files/fs/uploadstatus — query: {uploadId...}
alignment_get: GET /files/{id}/alignment — id=fileId
alignment_set: PUT /files/{id}/alignment — id=fileId, body: alignment
alignment_set_matrix: POST /files/{id}/alignment/matrix — id=fileId, body: matrix
alignment_delete: DELETE /files/{id}/alignment — id=fileId
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Primary resource ID — required when the action path contains {id} | |
| body | No | JSON request body for POST/PUT/PATCH (and some DELETE) actions | |
| query | No | Query parameters as key-value pairs | |
| subId | No | Secondary resource ID — required when the action path contains {subId} | |
| action | Yes | Endpoint to call (see tool description) | |
| region | Yes | Trimble Connect region: us (North America), eu (Europe), ap (Asia-Pacific), ap-au (Australia) | |
| extraId | No | Tertiary resource ID — required when the action path contains {extraId} | |
| version | No | Version number — required when the action path contains {version} | |
| projectId | No | Project ID — required when the action path contains {projectId} | |
| bcfVersion | No | BCF API version for BCF actions (default 2.1) |