Trello

trello Checklists API

Operations for creating, retrieving, updating, and deleting checklists and their check items on cards.

GitHub OpenAPI
Business capability
Project Management BC-900.30

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /checklists Add a checklist to a card · Create a Checklist #
Ask an LLM
“How do I add a checklist to a Trello card?”
“Can I copy an existing checklist onto another card?”
Tell an agent
Add a checklist named {name} to card {idCard}.
Copy checklist {idChecklistSource} onto card {idCard}.
GET /checklists/{id} Get a checklist with its items · Get a Checklist #
Ask an LLM
“How do I fetch a whole checklist including its check items?”
“Can I get a checklist along with the card it sits on?”
Tell an agent
Get checklist {id}.
Fetch checklist {id} with check items set to {checkItems}.
PUT /checklists/{id} Rename or reorder a checklist · Update a Checklist #
Ask an LLM
“Can I rename a checklist on a card?”
“How do I move a checklist to the top of a card?”
Tell an agent
Rename checklist {id} to {name}.
Move checklist {id} to position {pos}.
DELETE /checklists/{id} Delete a checklist · Delete a Checklist #
Ask an LLM
“How do I delete an entire checklist from a card?”
“Is removing a checklist permanent?”
Tell an agent destructive · confirm first
Delete checklist {id}.
Permanently remove checklist {id} and its items.
GET /checklists/{id}/checkItems List the items on a checklist · Get Check Items on a Checklist #
Ask an LLM
“What items are on a checklist, and which are done?”
“Can I list only the incomplete items on a checklist?”
Tell an agent
List the check items on checklist {id}.
Show checklist {id}'s items filtered by {filter}.
POST /checklists/{id}/checkItems Add an item to a checklist · Create a Check Item on a Checklist #
Ask an LLM
“How do I add a to-do item to an existing checklist?”
“Can I assign a new checklist item to someone and give it a due date?”
Tell an agent
Add item {name} to checklist {id}.
Add {name} to checklist {id}, due {due} and assigned to {idMember}.
GET /checklists/{id}/checkItems/{idCheckItem} Get a single checklist item · Get a Check Item on a Checklist #
Ask an LLM
“How do I check whether one specific checklist item is complete?”
“Can I fetch a single check item by its id?”
Tell an agent
Get check item {idCheckItem} on checklist {id}.
Show the state of item {idCheckItem} in checklist {id}.
DELETE /checklists/{id}/checkItems/{idCheckItem} Remove an item from a checklist · Delete a Check Item from a Checklist #
Ask an LLM
“How do I delete a single item from a checklist without deleting the checklist?”
“Can I remove a check item that was added by mistake?”
Tell an agent destructive · confirm first
Delete check item {idCheckItem} from checklist {id}.
Remove item {idCheckItem} on checklist {id}.
GET /checklists/{id}/{field} Read one field of a checklist · Get field on a Checklist #
Ask an LLM
“Can I read just the name or position of a checklist?”
“What's the lightest way to fetch a single checklist field?”
Tell an agent
Get the {field} field of checklist {id}.
Read only {field} from checklist {id}.
PUT /checklists/{id}/{field} Set one field of a checklist · Update field on a Checklist #
Ask an LLM
“Can I update a single checklist field by naming it in the URL?”
“Is there a per-field way to change a checklist's name or pos?”
Tell an agent
Set field {field} of checklist {id} to {value}.
Update only the {field} of checklist {id} to {value}.
GET /checklists/{id}/board Get the board a checklist belongs to · Get the Board the Checklist is on #
Ask an LLM
“Which board is this checklist on?”
“Can I find the board from just a checklist id?”
Tell an agent
Get the board that checklist {id} is on.
Show fields {fields} of the board holding checklist {id}.
GET /checklists/{id}/cards Get the card a checklist is on · Get the Card a Checklist is on #
Ask an LLM
“Which card does a checklist belong to?”
“How do I get from a checklist id back to its card?”
Tell an agent
Get the card that checklist {id} is on.
Find the parent card of checklist {id}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/trello/rest/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/openapi/trello-checklists-api-openapi.yml

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/trello:trello-checklists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

trello-checklists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Trello Checklists API
  version: '1.0'
  description: 'Operations tagged Checklists across 2 of this provider''s published API definitions: trello-rest-api-openapi.yml, trello-rest-api-swagger-v3.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.trello.com/1
  description: Trello API v1 Production Server
tags:
- name: Checklists
  description: Operations for creating, retrieving, updating, and deleting checklists and their check items on cards.
paths:
  /checklists:
    post:
      operationId: createChecklist
      summary: Create a Checklist
      description: Creates a new checklist, optionally on a specific card.
      tags:
      - Checklists
      parameters:
      - name: idCard
        in: query
        required: true
        description: The ID of the card the checklist should be on.
        schema:
          type: string
      - name: name
        in: query
        description: The name of the checklist.
        schema:
          type: string
      - name: pos
        in: query
        description: The position of the checklist on the card.
        schema:
          type: string
          default: bottom
      - name: idChecklistSource
        in: query
        description: The ID of a source checklist to copy.
        schema:
          type: string
      responses:
        '200':
          description: Successfully created the checklist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Checklist'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
      security:
      - apiKey: []
        apiToken: []
    servers:
    - url: https://api.trello.com/1
      description: Trello API v1 Production Server
  /checklists/{id}:
    get:
      operationId: getChecklist
      summary: Get a Checklist
      description: Retrieves a single checklist by its identifier.
      tags:
      - Checklists
      parameters:
      - $ref: '#/components/parameters/idParam'
      - name: cards
        in: query
        description: Filter cards to include.
        schema:
          type: string
          enum:
          - all
          - closed
          - none
          - open
          - visible
          default: none
      - name: checkItems
        in: query
        description: Whether to include check items.
        schema:
          type: string
          enum:
          - all
          - none
          default: all
      - name: checkItem_fields
        in: query
        description: A comma-separated list of check item fields to return.
        schema:
          type: string
          default: name,nameData,pos,state,due,dueReminder,idMember
      - name: fields
        in: query
        description: A comma-separated list of checklist fields to return.
        schema:
          type: string
          default: all
      responses:
        '200':
          description: Successfully retrieved the checklist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Checklist'
        '401':
          description: Unauthorized.
        '404':
          description: Checklist not found.
      security:
      - apiKey: []
        apiToken: []
    put:
      operationId: updateChecklist
      summary: Update a Checklist
      description: Updates a checklist's name or position.
      tags:
      - Checklists
      parameters:
      - $ref: '#/components/parameters/idParam'
      - name: name
        in: query
        description: The new name for the checklist.
        schema:
          type: string
      - name: pos
        in: query
        description: The new position for the checklist.
        schema:
          type: string
      responses:
        '200':
          description: Successfully updated the checklist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Checklist'
        '401':
          description: Unauthorized.
        '404':
          description: Checklist not found.
      security:
      - apiKey: []
        apiToken: []
    delete:
      operationId: deleteChecklist
      summary: Delete a Checklist
      description: Permanently deletes a checklist.
      tags:
      - Checklists
      parameters:
      - $ref: '#/components/parameters/idParam'
      responses:
        '200':
          description: Successfully deleted the checklist.
        '401':
          description: Unauthorized.
        '404':
          description: Checklist not found.
      security:
      - apiKey: []
        apiToken: []
    parameters:
    - name: id
      in: path
      description: ID of a checklist.
      required: true
      schema:
        $ref: '#/components/schemas/TrelloID'
    servers:
    - url: https://api.trello.com/1
      description: Trello API v1 Production Server
  /checklists/{id}/checkItems:
    get:
      operationId: getChecklistCheckItems
      summary: Get Check Items on a Checklist
      description: Retrieves all check items on a checklist.
      tags:
      - Checklists
      parameters:
      - $ref: '#/components/parameters/idParam'
      - name: filter
        in: query
        description: Filter check items by state.
        schema:
          type: string
          enum:
          - all
          - none
          default: all
      - name: fields
        in: query
        description: A comma-separated list of check item fields to return.
        schema:
          type: string
          default: name,nameData,pos,state,due,dueReminder,idMember
      responses:
        '200':
          description: Successfully retrieved check items.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CheckItem'
        '401':
          description: Unauthorized.
        '404':
          description: Checklist not found.
      security:
      - apiKey: []
        apiToken: []
    post:
      operationId: createCheckItem
      summary: Create a Check Item on a Checklist
      description: Creates a new check item on a checklist.
      tags:
      - Checklists
      parameters:
      - $ref: '#/components/parameters/idParam'
      - name: name
        in: query
        required: true
        description: The name of the check item.
        schema:
          type: string
          minLength: 1
          maxLength: 16384
      - name: pos
        in: query
        description: The position of the check item in the checklist.
        schema:
          type: string
          default: bottom
      - name: checked
        in: query
        description: Whether the check item is initially checked.
        schema:
          type: boolean
          default: false
      - name: due
        in: query
        description: A due date for the check item.
        schema:
          type: string
          format: date-time
      - name: idMember
        in: query
        description: The ID of a member to assign to the check item.
        schema:
          type: string
      responses:
        '200':
          description: Successfully created the check item.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckItem'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
        '404':
          description: Checklist not found.
      security:
      - apiKey: []
        apiToken: []
    parameters:
    - name: id
      in: path
      description: ID of a checklist.
      required: true
      schema:
        $ref: '#/components/schemas/TrelloID'
    servers:
    - url: https://api.trello.com/1
      description: Trello API v1 Production Server
  /checklists/{id}/checkItems/{idCheckItem}:
    get:
      operationId: getCheckItem
      summary: Get a Check Item on a Checklist
      description: Retrieves a specific check item on a checklist.
      tags:
      - Checklists
      parameters:
      - $ref: '#/components/parameters/idParam'
      - name: idCheckItem
        in: path
        required: true
        description: The ID of the check item.
        schema:
          type: string
      responses:
        '200':
          description: Successfully retrieved the check item.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckItem'
        '401':
          description: Unauthorized.
        '404':
          description: Checklist or check item not found.
      security:
      - apiKey: []
        apiToken: []
    delete:
      operationId: deleteCheckItem
      summary: Delete a Check Item from a Checklist
      description: Removes a check item from a checklist.
      tags:
      - Checklists
      parameters:
      - $ref: '#/components/parameters/idParam'
      - name: idCheckItem
        in: path
        required: true
        description: The ID of the check item to delete.
        schema:
          type: string
      responses:
        '200':
          description: Successfully deleted the check item.
        '401':
          description: Unauthorized.
        '404':
          description: Checklist or check item not found.
      security:
      - apiKey: []
        apiToken: []
    parameters:
    - name: id
      in: path
      description: ID of a checklist.
      required: true
      schema:
        $ref: '#/components/schemas/TrelloID'
    - name: idCheckItem
      in: path
      description: ID of the check item to retrieve.
      required: true
      schema:
        $ref: '#/components/schemas/TrelloID'
    servers:
    - url: https://api.trello.com/1
      description: Trello API v1 Production Server
  /checklists/{id}/{field}:
    parameters:
    - name: id
      in: path
      description: ID of a checklist.
      required: true
      schema:
        $ref: '#/components/schemas/TrelloID'
    - name: field
      in: path
      description: Field to update.
      required: true
      schema:
        type: string
        enum:
        - name
        - pos
    get:
      tags:
      - Checklists
      summary: Get field on a Checklist
      description: ''
      operationId: get-checklists-id-field
      security:
      - OAuth2:
        - read:board:trello
      responses:
        '200':
          description: Success
    put:
      tags:
      - Checklists
      summary: Update field on a Checklist
      description: ''
      operationId: put-checklists-id-field
      security:
      - OAuth2:
        - read:board:trello
        - write:board:trello
      parameters:
      - name: value
        in: query
        description: The value to change the checklist name to. Should be a string of length 1 to 16384.
        required: true
        schema:
          oneOf:
          - $ref: '#/components/schemas/posStringOrNumber'
          - $ref: '#/components/schemas/TrelloID'
      deprecated: false
      responses:
        '200':
          description: Success
    servers:
    - url: https://api.trello.com/1
  /checklists/{id}/board:
    get:
      tags:
      - Checklists
      summary: Get the Board the Checklist is on
      description: ''
      operationId: get-checklists-id-board
      security:
      - OAuth2:
        - read:board:trello
      parameters:
      - name: id
        in: path
        description: ID of a checklist.
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      - name: fields
        in: query
        description: '`all` or a comma-separated list of board [fields](/cloud/trello/guides/rest-api/object-definitions/)'
        required: false
        schema:
          type: string
          enum:
          - all
          - name
          default: all
      deprecated: false
      responses:
        '200':
          description: Success
    servers:
    - url: https://api.trello.com/1
  /checklists/{id}/cards:
    get:
      tags:
      - Checklists
      summary: Get the Card a Checklist is on
      description: ''
      operationId: get-checklists-id-cards
      security:
      - OAuth2:
        - read:board:trello
      parameters:
      - name: id
        in: path
        description: ID of a checklist.
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      deprecated: false
      responses:
        '200':
          description: Success
    servers:
    - url: https://api.trello.com/1
components:
  parameters:
    idParam:
      name: id
      in: path
      required: true
      description: The ID of the resource.
      schema:
        type: string
  schemas:
    CheckItem:
      type: object
      description: Represents a single item in a checklist that can be checked or unchecked.
      properties:
        id:
          type: string
          description: The unique identifier for the check item.
        name:
          type: string
          description: The name of the check item.
        state:
          type: string
          description: The completion state of the check item.
          enum:
          - complete
          - incomplete
        idChecklist:
          type: string
          description: The ID of the checklist the check item belongs to.
        pos:
          type: number
          description: The position of the check item in the checklist.
        due:
          type: string
          format: date-time
          description: The due date for the check item.
        idMember:
          type: string
          description: The ID of the member assigned to the check item.
    Checklist:
      type: object
      description: Represents a checklist on a card, containing a list of check items that can be marked as complete or incomplete.
      properties:
        id:
          type: string
          description: The unique identifier for the checklist.
        name:
          type: string
          description: The name of the checklist.
        idBoard:
          type: string
          description: The ID of the board the checklist belongs to.
        idCard:
          type: string
          description: The ID of the card the checklist is on.
        pos:
          type: number
          description: The position of the checklist on the card.
        checkItems:
          type: array
          description: The check items in the checklist.
          items:
            $ref: '#/components/schemas/CheckItem'
    TrelloID:
      type: string
      pattern: ^[0-9a-fA-F]{24}$
      example: 5abbe4b7ddc1b351ef961414
    posStringOrNumber:
      oneOf:
      - type: string
        enum:
        - top
        - bottom
      - type: number
        format: float
        example: 1293.5
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: Your Trello API key, obtained from the Power-Ups admin page at https://trello.com/power-ups/admin.
    apiToken:
      type: apiKey
      in: query
      name: token
      description: A user token that grants access to Trello resources. Obtained by authorizing via the /1/authorize route or OAuth 1.0.
    APIKey:
      type: apiKey
      in: query
      name: key
    APIToken:
      in: query
      name: token
      type: apiKey
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.atlassian.com/authorize
          tokenUrl: https://auth.atlassian.com/authorize/oauth/token
          scopes:
            read:board:trello: Read cards, lists, and comments in boards.
            write:board:trello: Create and update cards, lists, and comments in boards.
            write:board:membership:trello: Add, remove, or modify memberships on boards.
            read:organization:trello: Read workspaces.
            write:organization:trello: Update workspaces.
            write:organization:membership:trello: Add, remove, or modify memberships on workspaces.
            read:member:trello: Read email address, public name, public avatar, and memberships of boards, workspaces, and enterprises.
            write:member:trello: Upload custom emojis and stickers, star boards, and save searches.
            read:enterprise:trello: Read enterprises.
            write:enterprise:trello: Update and manage enterprises.
externalDocs:
  description: Trello REST API Documentation
  url: https://developer.atlassian.com/cloud/trello/rest/
x-refined-from:
- trello-rest-api-openapi.yml
- trello-rest-api-swagger-v3.json