tc_psets
Manage property set libraries, definitions, and instances for Trimble Connect model objects. Perform CRUD operations, validate property schemas, handle bulk changesets, and access version history.
Instructions
Trimble Connect Property Set Service (PSet): libraries, definitions, pset instances, policies, changesets. Regional service URI is resolved automatically. In pset paths, 'link' is the FRN of the external resource (e.g. model object). Select the endpoint with the "action" parameter. Path placeholders {projectId}/{id}/{subId}/{extraId}/{version} are filled from the matching input parameters. Actions:
me: GET /me — current user info
library_create: POST /libs — body: library definition
library_get: GET /libs/{id} — id=libId
library_update: PATCH /libs/{id} — id=libId, body: fields to update
library_delete: DELETE /libs/{id} — id=libId
library_policy_get: GET /libs/{id}/policy — id=libId
library_policy_put: PUT /libs/{id}/policy — id=libId, body: access control policy
definitions_list: GET /libs/{id}/defs — id=libId, query: {top?, skiptoken?, prefix?}
definition_create: POST /libs/{id}/defs — id=libId, body: definition with data schema
definition_get: GET /libs/{id}/defs/{subId} — id=libId, subId=defId
definition_update: PATCH /libs/{id}/defs/{subId} — id=libId, subId=defId, body: fields to update
definition_delete: DELETE /libs/{id}/defs/{subId} — id=libId, subId=defId
definition_versions: GET /libs/{id}/defs/{subId}/versions — id=libId, subId=defId
definition_version_get: GET /libs/{id}/defs/{subId}/versions/{version} — id=libId, subId=defId, version=version number
definition_schema_get: GET /libs/{id}/defs/{subId}/schema/{version} — id=libId, subId=defId, version=schema version
definition_validate: POST /libs/{id}/defs/{subId}/validate — id=libId, subId=defId, body: values to validate
psets_list_by_definition: GET /libs/{id}/defs/{subId}/psets — id=libId, subId=defId
psets_list_for_link: GET /psets/{id} — id=link (FRN), query: {top?, skiptoken?}
pset_get: GET /psets/{id}/{subId}/{extraId} — id=link, subId=libId, extraId=defId
pset_update: PATCH /psets/{id}/{subId}/{extraId} — id=link, subId=libId, extraId=defId, body: {props}
pset_delete: DELETE /psets/{id}/{subId}/{extraId} — id=link, subId=libId, extraId=defId
pset_versions: GET /psets/{id}/{subId}/{extraId}/versions — id=link, subId=libId, extraId=defId
pset_version_get: GET /psets/{id}/{subId}/{extraId}/versions/{version} — id=link, subId=libId, extraId=defId, version
batch_get: POST /batch-get — body: {psets:[{libId, defId, link, v?}]}
changeset: POST /psets/changeset — body: changeset (bulk create/update)
changeset_async: POST /psets/changeset-async — body: changeset
changeset_status: GET /psets/changeset/{id} — id=changesetId
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) |