tc_bcf
Manage BCF topics, comments, viewpoints, and document references within Trimble Connect projects. Perform CRUD and batch operations via a single endpoint.
Instructions
Trimble Connect BCF/Topic API (default 2.1, set bcfVersion='3.0' for BCF 3.0): topics, comments, viewpoints, extensions, document references, batch operations. Select the endpoint with the "action" parameter. Path placeholders {projectId}/{id}/{subId}/{extraId}/{version} are filled from the matching input parameters. Actions:
list_projects: GET /projects
get_project: GET /projects/{projectId}
extensions_get: GET /projects/{projectId}/extensions — topic types, statuses, priorities, labels, users
extensions_update: PUT /projects/{projectId}/extensions — body: extensions
default_extensions: GET /projects/{projectId}/defaultextensions
topics_list: GET /projects/{projectId}/topics — query: OData filters supported ($filter, $orderby...)
topic_get: GET /projects/{projectId}/topics/{id} — id=topicId (guid)
topic_create: POST /projects/{projectId}/topics — body: {title, description?, topic_type?, priority?, assigned_to?, topic_status?...}
topic_update: PUT /projects/{projectId}/topics/{id} — id=topicId, body: full topic object
topic_delete: DELETE /projects/{projectId}/topics/{id} — id=topicId
topics_batch_create: POST /projects/{projectId}/topics/batch — body: array of topics
topics_batch_update: PATCH /projects/{projectId}/topics/batch — body: array of topic patches
comments_list: GET /projects/{projectId}/topics/{id}/comments — id=topicId
comment_get: GET /projects/{projectId}/topics/{id}/comments/{subId} — id=topicId, subId=commentId
comment_create: POST /projects/{projectId}/topics/{id}/comments — id=topicId, body: {comment}
comment_update: PUT /projects/{projectId}/topics/{id}/comments/{subId} — id=topicId, subId=commentId, body: {comment}
comment_delete: DELETE /projects/{projectId}/topics/{id}/comments/{subId} — id=topicId, subId=commentId
comments_batch_create: POST /projects/{projectId}/comments/batch — body: array of comments
comments_batch_update: PATCH /projects/{projectId}/comments/batch — body: array of comment patches
viewpoints_list: GET /projects/{projectId}/topics/{id}/viewpoints — id=topicId
viewpoint_get: GET /projects/{projectId}/topics/{id}/viewpoints/{subId} — id=topicId, subId=viewpointId
viewpoint_create: POST /projects/{projectId}/topics/{id}/viewpoints — id=topicId, body: viewpoint (camera, snapshot base64...)
viewpoint_delete: DELETE /projects/{projectId}/topics/{id}/viewpoints/{subId} — id=topicId, subId=viewpointId
viewpoint_selection: GET /projects/{projectId}/topics/{id}/viewpoints/{subId}/selection — id=topicId, subId=viewpointId
viewpoint_coloring: GET /projects/{projectId}/topics/{id}/viewpoints/{subId}/coloring — id=topicId, subId=viewpointId
viewpoint_visibility: GET /projects/{projectId}/topics/{id}/viewpoints/{subId}/visibility — id=topicId, subId=viewpointId
related_topics_get: GET /projects/{projectId}/topics/{id}/related_topics — id=topicId
related_topics_update: PUT /projects/{projectId}/topics/{id}/related_topics — id=topicId, body: related topics
topic_files_get: GET /projects/{projectId}/topics/{id}/files — id=topicId
topic_files_update: PUT /projects/{projectId}/topics/{id}/files — id=topicId, body: file references
document_references_list: GET /projects/{projectId}/topics/{id}/document_references — id=topicId
document_reference_create: POST /projects/{projectId}/topics/{id}/document_references — id=topicId, body: document reference
document_reference_update: PUT /projects/{projectId}/topics/{id}/document_references/{subId} — id=topicId, subId=documentReferenceId, body
document_reference_delete: DELETE /projects/{projectId}/topics/{id}/document_references/{subId} — id=topicId, subId=documentReferenceId
documents_list: GET /projects/{projectId}/documents
document_get: GET /projects/{projectId}/documents/{id} — id=documentId
objects: GET /projects/{projectId}/objects
changes: GET /projects/{projectId}/changes — query: change tracking params
current_user: GET /current-user
bcf_versions: GET /bcf/versions — supported BCF versions
foundation_versions: GET /foundation/versions
foundation_auth: GET /foundation/1.0/auth
foundation_current_user: GET /foundation/1.0/current-user
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) |