Connect Trimble Trimble Connect API
Community OpenAPI document · agent-readyStorageDocument Managementbearer190 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For 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.
Use for: Upload a new revision of a drawing into a project folder, List all files inside a specific project folder, Create a coordination view with a markup on a clashing element, Check out a file so no one else edits it while I work
Not supported: Does not handle cost estimating, scheduling, or accounting. Use for Trimble Connect project file management and model coordination only.
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.
Install Jentic One Beta
Connect the Trimble Connect API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Trimble Connect API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fconnect.trimble.com%2Fconnect-trimble" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fconnect.trimble.com%2Fconnect-trimble" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Trimble Connect API.
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
Patterns agents use Trimble Connect API for, with concrete tasks.
★ 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.
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.
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.
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.
Add a new user to a project with the reviewer role and grant them read permission on the Drawings folder
Key Endpoints
190 endpoints — the trimble connect api reads, writes, and organizes project files and folders in trimble's construction collaboration platform.
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
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
Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Trimble Connect API through Jentic.
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.
GET STARTED