Trimble To Dos API

APIs related to ToDos

GitHub OpenAPI

Operations 9

GET /todos List all ToDos #
POST /todos Create a New ToDo #
GET /todos/types List all Todo Types of a Project #
GET /todos/{todoId} Get ToDo Details #
PATCH /todos/{todoId} Update ToDo #
DELETE /todos/{todoId} Delete a ToDo #
GET /todos/{todoId}/attachments List all attachments #
POST /todos/{todoId}/attachments Add attachments #
DELETE /todos/{todoId}/attachments Remove attachments #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/trimble:trimble-todos-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

trimble-todos-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Trimble Connect To Dos API
  description: '# Overview

    The Trimble Connect API allows you to read, write, and update data into and out of the Connect platform. Now, you can create folders, upload and download files, modify views, and do much more from any application.


    Documentation for this service is available on the Trimble Developer site.


    # Getting started

    **You must agree to the Terms of Service to use Connect services.**


    You need to complete the steps in the Getting started guide to be able to call the API.


    # Concepts

    Please see Common Concepts in the Connect Platform documentation.


    ## Paginated Responses

    All collections/lists support a Range header to fetch partial lists (HTTP 206) - the positions are zero-indexed & inclusive


    + Request Header

    ```

    Range: items=25-34

    ```


    + Response Header


    ```

    Content-Range: items 25-34/40

    ```


    ## If-Match Header

    Some APIs support the If-Match header, especially for changing data on objects. Using this, the API user can ensure that the changes are being done to the latest version.


    The APIs that support this header are:


    + **PATCH /folders**

    + **PATCH /files**


    ## Limits

    + There is a maximum length of 255 characters for project, company, folder, file, group, release, views, and clash names.

    + There is a maximum length of 40 characters for tag labels.'
  version: '2.0'
  contact:
    name: Trimble Connect Support
    url: https://connect.trimble.com
    email: connect-support@trimble.com
  license:
    name: Trimble Connect SDK Internal Use License
    url: https://developer.trimble.com/docs/connect/terms/SDK-IU-license-agreement
  termsOfService: https://developer.trimble.com/docs/connect/terms
servers:
- url: https://app.connect.trimble.com/tc/api/2.0
  description: PROD US master region
- url: https://app21.connect.trimble.com/tc/api/2.0
  description: PROD EU region
- url: https://app22.connect.trimble.com/tc/api/2.0
  description: PROD UK region
- url: https://app31.connect.trimble.com/tc/api/2.0
  description: PROD AP region
- url: https://app32.connect.trimble.com/tc/api/2.0
  description: PROD AP2 region
- url: https://app.stage.connect.trimble.com/tc/api/2.0
  description: STAGE US master region
- url: https://app31.stage.connect.trimble.com/tc/api/2.0
  description: STAGE AP region
- url: https://app21.stage.connect.trimble.com/tc/api/2.0
  description: STAGE EU region
- url: https://app.connect.trimble.com/tc/api
  description: PROD US master region (v2.1)
- url: https://app21.connect.trimble.com/tc/api
  description: PROD EU region (v2.1)
- url: https://app22.connect.trimble.com/tc/api
  description: PROD UK region (v2.1)
- url: https://app31.connect.trimble.com/tc/api
  description: PROD AP region (v2.1)
- url: https://app32.connect.trimble.com/tc/api
  description: PROD AP2 region (v2.1)
- url: https://app.stage.connect.trimble.com/tc/api
  description: STAGE US master region (v2.1)
- url: https://app31.stage.connect.trimble.com/tc/api
  description: STAGE AP region (v2.1)
- url: https://app21.stage.connect.trimble.com/tc/api
  description: STAGE EU region (v2.1)
security:
- Bearer: []
tags:
- name: ToDos
  description: APIs related to ToDos
paths:
  /todos:
    get:
      tags:
      - ToDos
      summary: List all ToDos
      description: 'This API returns the list of todos in a project based on either project Id or file

        Id using which todos are created.'
      operationId: ListallToDos
      parameters:
      - name: projectId
        in: query
        description: ID of the Project
        required: true
        schema:
          type: string
          example: v1Cx5gm2F7h
      - name: fileId
        in: query
        description: ID of the file linked to the todo. This is optional if projectId is provided, else required if versionId is specified. If fileId alone is passed, latest version of file is considered for listing ToDos.
        schema:
          type: string
          example: PdtcatZR264
      - name: versionId
        in: query
        description: ID of specific version of the file passed.
        schema:
          type: string
          example: PdtcatZR265
      responses:
        '206':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ToDoDetailsResponse'
                description: ''
                example:
                - id: woC32em2Fb0
                  label: PROJ-21
                  type: Comment
                  title: PROJ-21-Title
                  description: Fix the fire rating issue
                  dueDate: '2015-05-21'
                  percentComplete: 11
                  status: NEW
                  priority: NORMAL
                  projectId: woC32em2Fb0
                  createdOn: 2015-01-21T16:06:09-0800
                  createdBy:
                    id: Dyfw481f305
                    firstName: John
                    lastName: Doe
                    email: johndoe@trimble.com
                    status: ACTIVE
                  modifiedOn: 2015-01-21T16:06:09-0800
                  modifiedBy:
                    id: Dyfw481f306
                    firstName: John
                    lastName: Doe
                    email: johndoe@trimble.com
                    status: ACTIVE
                - id: woC32em2Fb0
                  label: PROJ-22
                  type: Issue
                  title: PROJ-22-Title
                  description: Fix the thermal rating issue
                  dueDate: 2015-05-21T16:06:09-0800
                  percentComplete: 11
                  status: CLOSED
                  priority: NORMAL
                  projectId: woC32em2Fb0
                  restricted: true
                  createdOn: 2015-01-21T16:06:09-0800
                  createdBy:
                    id: Dyfw481f307
                    firstName: John
                    lastName: Doe
                    email: johndoe@trimble.com
                    status: ACTIVE
                  modifiedOn: 2015-01-21T16:06:09-0800
                  modifiedBy:
                    id: Dyfw481f308
                    firstName: John
                    lastName: Doe
                    email: johndoe@trimble.com
                    status: ACTIVE
    post:
      tags:
      - ToDos
      summary: Create a New ToDo
      description: 'You may create a new ToDo using this action.

        + description (string) - The details of the ToDo

        + projectId (string) - Project Identifier


        Optional parameters you can define on creation:

        - type (follow BCF 2.0 spec)

        - title

        - label

        - dueDate

        - percentComplete

        - status

        - priority

        - assignees'
      operationId: CreateaNewToDo
      parameters: []
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateaNewToDoRequest'
        required: true
      responses:
        '201':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToDoDetailsResponse'
  /todos/types:
    get:
      tags:
      - ToDos
      summary: List all Todo Types of a Project
      operationId: ListallTodoTypesofaProject
      parameters:
      - name: projectId
        in: query
        description: ID of the Project
        required: true
        schema:
          type: string
          example: Dyfw481f309
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
              example:
              - Comment
              - Issue
              - Request
              - Solution
              - Fault
              - Clash
              - Inquiry
              - Remark
              - Undefined
              - Engineering
              - Architecture
  /todos/{todoId}:
    get:
      tags:
      - ToDos
      summary: Get ToDo Details
      operationId: GetToDoDetails
      parameters:
      - name: todoId
        in: path
        description: ID of the ToDo
        required: true
        schema:
          type: string
          example: woC32em2Fb0
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToDoDetailsResponse'
    patch:
      tags:
      - ToDos
      summary: Update ToDo
      description: 'This API allows you to update the following properties of the ToDo:


        Note : Custom ToDo Label would not be updated from here.


        - type


        - title


        - label


        - description


        - dueDate


        - percentComplete


        - status


        - priority


        - assignees'
      operationId: UpdateToDo
      parameters:
      - name: todoId
        in: path
        description: ID of the ToDo
        required: true
        schema:
          type: string
          example: woC32em2Fb0
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateToDoRequest'
        required: true
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToDoDetailsResponse'
    delete:
      tags:
      - ToDos
      summary: Delete a ToDo
      operationId: DeleteToDo
      parameters:
      - name: todoId
        in: path
        description: ID of the ToDo
        required: true
        schema:
          type: string
          example: woC32em2Fb0
      responses:
        '204':
          description: ''
          headers: {}
  /todos/{todoId}/attachments:
    get:
      tags:
      - ToDos
      summary: List all attachments
      description: These sets of APIs allow you to list attachments to a ToDo.
      operationId: Listallattachments
      parameters:
      - name: todoId
        in: path
        description: ID of the ToDo
        required: true
        schema:
          type: string
          example: v1Cx5gm2F7h
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TodoAttachmentDetailsResponse'
                description: ''
    post:
      tags:
      - ToDos
      summary: Add attachments
      description: These sets of APIs allow you to add attachments to a ToDo.
      operationId: Addattachments
      parameters:
      - name: todoId
        in: path
        description: ID of the ToDo
        required: true
        schema:
          type: string
          example: v1Cx5gm2F7h
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/AddTodoattachmentsRequest'
              description: ''
        required: true
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TodoAttachmentDetailsResponse'
                description: ''
    delete:
      tags:
      - ToDos
      summary: Remove attachments
      description: These sets of APIs allow you to remove attachments to a ToDo.
      operationId: Removeattachments
      parameters:
      - name: todoId
        in: path
        description: ID of the ToDo
        required: true
        schema:
          type: string
          example: v1Cx5gm2F7h
      - name: id
        in: query
        description: ID of the attachment
        required: true
        schema:
          type: string
          example: woC32em2Fb0
      - name: type
        in: query
        description: Type of attachment
        required: true
        schema:
          type: string
          example: FILE
      responses:
        '204':
          description: ''
          headers: {}
components:
  schemas:
    UpdateToDoRequest:
      title: UpdateToDoRequest
      type: object
      properties:
        type:
          type: string
          enum:
          - Fault
          - Clash
          - Request
          - Inquiry
          - Remark
          - Comment
          - Issue
          - Request
          - Solution
          description: Type of the ToDo
        title:
          type: string
          description: Title of the ToDo
        label:
          type: string
          description: Unique label for the ToDo within a project
        description:
          type: string
          description: Description about the ToDo
        dueDate:
          type: string
          description: (timestamp) - An ISO8601 Due date for the ToDo
        percentComplete:
          type: integer
          format: int32
          minimum: 0
          maximum: 100
          description: Progress percent
        status:
          type: string
          description: ToDo Status
          enum:
          - NEW
          - IN_PROGRESS
          - RESOLVED
          - BLOCKED
          - CLOSED
        priority:
          type: string
          description: ToDo Priority
          enum:
          - LOW
          - NORMAL
          - HIGH
          - CRITICAL
        assignees:
          $ref: '#/components/schemas/AssigneesRequest'
      example:
        description: Fix thermal rating to be 6+ hour
    TodoAttachmentDetailsResponse:
      title: AttachmentDetailsResponse
      required:
      - id
      - name
      - type
      - versionId
      - modifiedOn
      - modifiedBy
      - revision
      type: object
      properties:
        id:
          type: string
          description: Attachemnt identifier
        name:
          type: string
          description: Name of the attachment
        type:
          type: string
          description: Type of attachment ('FILE', 'VIEW', 'CLASH', 'VIEW2D', 'CLASHITEM')
        versionId:
          type: string
          description: Version Id of the object
        modifiedOn:
          type: string
          description: (timestamp) - An ISO8601 date when the Attachment was modified
        modifiedBy:
          $ref: '#/components/schemas/ModifiedBy'
        revision:
          type: integer
          format: int32
          description: Revision Number for file
      example:
        id: woC32em2Fb0
        name: Model.ifc
        type: FILE
        versionId: i3tSoF9Xgus
        modifiedOn: 2015-01-21T16:06:09-0800
        modifiedBy:
          id: Dyfw481f425
          firstName: John
          lastName: Doe
          email: johndoe@trimble.com
          status: ACTIVE
        revision: 1
    AddTodoattachmentsRequest:
      title: AddattachmentsRequest
      required:
      - id
      - type
      type: object
      properties:
        id:
          type: string
          description: Version Id of the attachment
        type:
          type: string
          description: Type of attachment
          enum:
          - FILE
          - VIEW
          - CLASHSET
          - CLASHITEM
          - VIEW2D
        embedded:
          type: string
          description: Flag to indicate embedded object attached, currently only apply to views
      example:
        id: woC32em2Fb0
        type: FILE
    AssigneeResponse:
      title: AssigneeResponse
      required:
      - id
      - type
      - firstName
      - lastName
      - name
      - email
      type: object
      description: Assignee are the users who got assigned with some task
      properties:
        id:
          type: string
          description: User identifier
        tiduuid:
          type: string
          description: Trimble ID of the user
        type:
          type: string
          enum:
          - USER
          - GROUP
          description: Type of assignee
        firstName:
          type: string
        lastName:
          type: string
        name:
          type: string
        email:
          type: string
      example:
        id: Dyfw481f431
        tiduuid: b4581f50-1e6c-4ccd-8a6c-af2ac07b31a6
        type: USER
        firstName: John
        lastName: Doe
        email: JDoe@trimble.com
        name: John Doe
    CreateaNewToDoRequest:
      title: CreateaNewToDoRequest
      required:
      - description
      - projectId
      type: object
      properties:
        description:
          type: string
          description: Description about the ToDo
        projectId:
          type: string
          description: Project id for the ToDo
        type:
          type: string
          enum:
          - Fault
          - Clash
          - Request
          - Inquiry
          - Remark
          - Comment
          - Issue
          - Request
          - Solution
          description: Type of the ToDo
        title:
          type: string
          description: Title of the ToDo
        label:
          type: string
          description: Unique label for the ToDo within a project
        dueDate:
          type: string
          description: (timestamp) - An ISO8601 Due date for the ToDo
        percentComplete:
          type: number
          format: int32
          minimum: 0
          maximum: 100
          description: Progress percent
        status:
          type: string
          description: ToDo Status
          enum:
          - NEW
          - IN_PROGRESS
          - RESOLVED
          - BLOCKED
          - CLOSED
        priority:
          type: string
          description: ToDo Priority
          enum:
          - LOW
          - NORMAL
          - HIGH
          - CRITICAL
        assignees:
          $ref: '#/components/schemas/AssigneesRequest'
      example:
        description: Fix thermal rating to be 6+ hour
        projectId: p8C921wm2Fb3
    Company:
      title: Company
      required:
      - name
      - website
      - image
      - role
      - createdOn
      - modifiedOn
      - createdBy
      - modifiedBy
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        website:
          type: string
        image:
          type: string
        role:
          type: string
        createdOn:
          type: string
        modifiedOn:
          type: string
        createdBy:
          $ref: '#/components/schemas/CreatedBy'
        modifiedBy:
          $ref: '#/components/schemas/ModifiedBy'
      example:
        name: Trimble.com
        website: gmail.com
        image: https://{baseURL}/tc/app/files/thumb?id=k-PEcTYK265&fc=COMPANYIMG#?1487053557000
        role: ADMIN
        createdOn: 2017-01-18T12:48:38+0000
        modifiedOn: 2017-02-14T06:25:57+0000
        createdBy:
          firstName: John
          lastName: Doe
          email: jdoe@trimble.com
          status: ACTIVE
        modifiedBy:
          firstName: John
          lastName: Doe
          email: jdoe@trimble.com
          status: ACTIVE
    ToDoDetailsResponse:
      title: ToDoDetailsResponse
      required:
      - id
      - title
      - label
      - description
      - status
      - priority
      - projectId
      - createdOn
      - createdBy
      - modifiedOn
      - modifiedBy
      type: object
      properties:
        id:
          type: string
          description: ToDo identifier
        type:
          type: string
          enum:
          - Fault
          - Clash
          - Request
          - Inquiry
          - Remark
          - Comment
          - Issue
          - Request
          - Solution
          description: Type of the ToDo
        title:
          type: string
          description: Title of the ToDo
        label:
          type: string
          description: Unique label for the ToDo within a project
        description:
          type: string
          description: Description about the ToDo
        dueDate:
          type: string
          description: (timestamp) - An ISO8601 Due date for the ToDo
        percentComplete:
          type: integer
          format: int32
          minimum: 0
          maximum: 100
          description: Progress percent
        status:
          type: string
          description: ToDo Status
          enum:
          - NEW
          - IN_PROGRESS
          - RESOLVED
          - BLOCKED
          - CLOSED
        priority:
          type: string
          description: ToDo Priority
          enum:
          - LOW
          - NORMAL
          - HIGH
          - CRITICAL
        projectId:
          type: string
          description: Project Identifier
        assignees:
          $ref: '#/components/schemas/AssigneeResponse'
        createdOn:
          type: string
          description: (timestamp) - An ISO8601 date when the ToDo was created
        createdBy:
          $ref: '#/components/schemas/CreatedBy'
        modifiedOn:
          type: string
          description: (timestamp) - An ISO8601 date when the ToDo was modified
        modifiedBy:
          $ref: '#/components/schemas/ModifiedBy'
      example:
        id: woC32em2Fb0
        type: Comment
        title: PROJ-21-Title
        label: PROJ-21
        description: Fix the fire rating issue
        dueDate: 2015-05-21T00:00:00+0000
        percentComplete: 11
        status: NEW
        priority: NORMAL
        projectId: woC32em2Fb0
        createdOn: 2015-01-21T16:06:09-0800
        createdBy:
          id: Dyfw481f423
          firstName: John
          lastName: Doe
          email: johndoe@trimble.com
          status: ACTIVE
        modifiedOn: 2015-01-21T16:06:09-0800
        modifiedBy:
          id: Dyfw481f424
          firstName: John
          lastName: Doe
          email: johndoe@trimble.com
          status: ACTIVE
    AssigneesRequest:
      title: AssigneesRequest
      required:
      - id
      - type
      type: object
      description: List of users or groups assigned to ToDo.
      properties:
        id:
          type: string
          description: Id of the user
        type:
          type: string
          enum:
          - USER
          - GROUP
          description: Type of assignee
      example:
        id: woC32em2Fb0
        type: USER
    CreatedBy:
      title: CreatedBy
      required:
      - id
      - firstName
      - lastName
      - email
      - status
      type: object
      description: User details of who created this object
      properties:
        id:
          type: string
          description: User identifier
        tiduuid:
          type: string
          description: Trimble ID of the user
        firstName:
          type: string
        lastName:
          type: string
        email:
          type: string
        status:
          type: string
          description: User status. User's status is PENDING when a new user has been invited to a project and has not access Connect yet. Once the user has accessed Connect, the status becomes ACTIVE. REMOVED is a project specific status that is shown for users that have been removed from a project.
          enum:
          - ACTIVE
          - PENDING
          - REMOVED
        company:
          $ref: '#/components/schemas/Company'
        companies:
          type: array
          items:
            $ref: '#/components/schemas/Company'
        companyAdmin:
          type: boolean
      example:
        id: LWOf7rirztM
        tiduuid: b75d4e5c-e4c0-4a92-9963-fcc5d36dd6a6
        firstName: John
        lastName: Doe
        email: jdoe@trimble.com
        status: ACTIVE
    ModifiedBy:
      title: ModifiedBy
      required:
      - id
      - firstName
      - lastName
      - email
      - status
      type: object
      description: User details of who modified this object recently
      properties:
        id:
          type: string
          description: User identifier
        tiduuid:
          type: string
          description: Trimble ID of the user
        firstName:
          type: string
        lastName:
          type: string
        email:
          type: string
        status:
          type: string
          description: User status. User's status is PENDING when a new user has been invited to a project and has not access Connect yet. Once the user has accessed Connect, the status becomes ACTIVE. REMOVED is a project specific status that is shown for users that have been removed from a project.
          enum:
          - ACTIVE
          - PENDING
          - REMOVED
      example:
        id: LWOf7rirztM
        tiduuid: b75d4e5c-e4c0-4a92-9963-fcc5d36dd6a6
        firstName: John
        lastName: Doe
        email: jdoe@trimble.com
        status: ACTIVE
  securitySchemes:
    Bearer:
      type: http
      description: The Trimble ID access token.
      scheme: bearer
      bearerFormat: JWT