canonical: https://jentic.com/apis/connect.trimble.com/connect-trimble # Connect Trimble Trimble Connect API The Trimble Connect API reads, writes, and organizes project files and folders in Trimble's construction collaboration platform. It uploads and downloads files with multipart transfers, tracks file versions with check-in and check-out, and manages folder and file permissions across a project. Beyond documents, it creates 3D and 2D coordination views with markups and section planes, raises clashes and ToDos against model objects, and bundles approved files into releases. ## For AI agents Upload, version, and permission project files and folders in Trimble Connect, and create coordination views, clashes, comments, and ToDos against model objects. Authenticates with a Trimble ID bearer token. ## Scope Does not handle cost estimating, scheduling, or accounting. Use for Trimble Connect project file management and model coordination only. ## Capabilities - Create and organize project folders, then upload and download files with multipart transfers - Track file versions and check files in and out to coordinate edits across a team - Set folder and file permissions to control who can reach each project resource - Create 3D and 2D views with markups, section planes, and camera positions for model coordination - Raise clashes, comments, and ToDos against project objects to run design coordination - Bundle files into releases and export activity logs for project auditing ## Use cases ### Agent-Driven Document Handling An AI agent connected through Jentic can file incoming drawings and models into the right Trimble Connect project folder, upload each as a new version, and set who may view or edit it. The agent finds the operation by intent, so it can initiate a multipart upload, complete it, and confirm the file version without a human navigating the web app. Example prompt: Initiate a multipart upload for revision C of a structural drawing into the Structural folder, complete the upload, and confirm the new file version was created ### Common Data Environment Sync Teams keep drawings, models, and documents in a single project store where every change is versioned. The Trimble Connect API lists folder contents, uploads new revisions, tracks versions, and manages permissions so an external system can mirror the project's folder tree and keep it current. Check-in and check-out prevent two people overwriting the same file. Example prompt: List the items in a project folder, download the latest version of each file, and check out one file for editing ### Model Coordination and Clash Review Coordinators review federated models, flag clashes between elements, and record decisions as views, markups, and ToDos. The Trimble Connect API creates clashes, saved 3D and 2D views with section planes and markups, and ToDos tied to objects, so a coordination workflow can be scripted end to end and its outputs saved back to the project. Example prompt: Create a 3D view focused on a clashing beam, add a markup describing the conflict, and open a ToDo assigned to the responsible discipline ### Project Team and Access Management Project administrators onboard companies and users, assign roles, and control folder permissions as teams change. The Trimble Connect API adds and removes users on a project, updates their roles, and manages company membership, letting an HR or onboarding system provision access to the right projects automatically. Example prompt: Add a new user to a project with the reviewer role and grant them read permission on the Drawings folder ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/projects` | List all projects | | POST | `/projects` | Create a new project | | POST | `/folders` | Create a new folder | | GET | `/folders/{folderId}/items` | List items in a folder | | POST | `/files/fs/initiate` | Initiate a file upload | | GET | `/files/{fileId}` | Get file details | | POST | `/views` | Create a view | | GET | `/clashsets` | List all clashes in a project | ## Key resources - **Projects** — List, create, update, and delete projects, and read project metrics, settings, roles, and members - **Folders** — Create folders, list their items, read versions, and manage folder permissions - **Files** — Upload and download files with multipart transfers, track versions, and check files in and out - **Views** — Create 3D and 2D views with markups, section planes, cameras, and presentations - **Clashes** — Create clashes, list clash items, and update or delete clash records - **Comments and ToDos** — Raise comments and ToDos with attachments against project objects - **Releases** — Bundle files into releases and download or manage the files they contain - **Users and Groups** — Manage project users, roles, company membership, and group membership ## Why Jentic - **Setup:** Wiring Trimble Connect by hand means handling its Trimble ID bearer token, picking the correct regional host from several instance URLs, and managing paginated Range headers yourself. Through Jentic you install once, import Trimble Connect from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** Trimble Connect carries the project, folder, and file ids in the URL path, so a rule can pin your agent to one project and the specific operations you pick. You choose which operations it may call, so file deletion or user removal are excluded unless you add them. - **Credential handling:** Your Trimble ID token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'upload a file to a project' or 'create a coordination view', and Jentic returns the matching Trimble Connect operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Box** — General-purpose file storage and collaboration rather than a construction-specific project store - **Dropbox** — Consumer and team file sync and sharing without project-based construction workflows - **Procore** — Construction project management for RFIs, budgets, and schedules alongside Trimble Connect's file store - **Smartsheet** — Spreadsheet-style project tracking that can sit alongside Trimble Connect document coordination ## FAQ ### What authentication does the Trimble Connect API use? The Trimble Connect API authenticates with a bearer token per its OpenAPI spec: you pass a Trimble ID access token as a JWT in the Authorization header. A couple of endpoints, such as listing available regions and opening a shared link by its share token, are public and need no token. Through Jentic your token is stored once by your own self-hosted instance and injected when the agent calls, so it never sits in the agent's prompt. ### Is there a Trimble Connect MCP server? You don't need an MCP server to give your agent the Trimble Connect API. Jentic connects it directly from the API Directory: import it, store your Trimble ID token once, and your agent calls the operations it needs. Operations are discovered on demand, so no extra tool definitions are loaded into the agent's context. ### Can I limit what my agent is allowed to do with the Trimble Connect API? Yes. Trimble Connect puts the project, folder, and file ids in the URL path, so you can write a rule that allows only the file-listing and upload operations under one project id, letting the agent read and add files for that project and touch nothing else. Destructive operations like deleting a folder or removing users are not included unless you add them, and every call the agent makes is logged. ### Can I manage file versions with the Trimble Connect API? Yes. The API tracks versions for both files and folders, and it supports check-in and check-out so an edit locks the file until it is checked back in. You can list the versions of a file, fetch a download URL for a specific one, and initiate or complete a multipart upload to add a new version. ### What are the rate limits for the Trimble Connect API? The OpenAPI spec does not specify rate limits. Check the Trimble Developer documentation at https://developer.trimble.com/docs/connect for current limits and usage guidance before running high-volume jobs. ### How do I upload a file to a project with the Trimble Connect API through Jentic? Search Jentic by intent, for example 'upload a file to a Trimble Connect project', and Jentic returns the matching upload operation with its input schema. Your agent initiates the multipart upload, completes it, and reads back the new file version. To run it on your own infrastructure, install Jentic One from its GitHub repo.