WeKan Cards API

The Cards API from WeKan — 19 operation(s) for cards.

Operations 24

DELETE /api/boards/{board}/cards/bulk Delete board cards bulk #
POST /api/boards/{board}/cards/labels Post board cards labels #
GET /api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue} Get board custom field value #
GET /api/boards/{board}/cards_count Get board cards count #
GET /api/boards/{board}/lists/{list}/cards Get board list cards #
POST /api/boards/{board}/lists/{list}/cards Post board list cards #
GET /api/boards/{board}/lists/{list}/cards/{card} Get board list card #
PUT /api/boards/{board}/lists/{list}/cards/{card} Put board list card #
DELETE /api/boards/{board}/lists/{list}/cards/{card} Delete board list card #
POST /api/boards/{board}/lists/{list}/cards/{card}/archive Post board list card archive #
POST /api/boards/{board}/lists/{list}/cards/{card}/assignees/{assignee} Post board list card assignee #
DELETE /api/boards/{board}/lists/{list}/cards/{card}/assignees/{assignee} Delete board list card assignee #
POST /api/boards/{board}/lists/{list}/cards/{card}/copy Post board list card copy #
POST /api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField} Post board list card custom field #
GET /api/boards/{board}/lists/{list}/cards/{card}/exportExcel Export a single card to Excel (.xlsx), formatted for DIN A4 Portrait printing #
POST /api/boards/{board}/lists/{list}/cards/{card}/members/{member} Post board list card member #
DELETE /api/boards/{board}/lists/{list}/cards/{card}/members/{member} Delete board list card member #
POST /api/boards/{board}/lists/{list}/cards/{card}/unarchive Post board list card unarchive #
POST /api/boards/{board}/lists/{list}/cards/bulk Post board list cards bulk #
GET /api/boards/{board}/lists/{list}/cards_count Get board list cards count #
GET /api/boards/{board}/swimlanes/{swimlane}/cards Get board swimlane cards #
GET /api/cards/{card} Get card #
GET /api/user/cards Get user cards #
POST /api/boards/{boardId}/swimlanes/{swimlaneId}/lists/{listId}/ics Import an iCalendar (.ics) file into a board as cards #

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/wekan:wekan-cards-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.

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

OpenAPI Specification

wekan-cards-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Wekan Cards API
  version: '1.0'
  description: 'Operations tagged Cards across 2 of this provider''s published API definitions: wekan-meteor3-openapi.yml, wekan-openapi.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: Cards
paths:
  /api/boards/{board}/cards/bulk:
    delete:
      operationId: delete_board_cards_bulk
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Delete board cards bulk
      x-summary-source: derived
  /api/boards/{board}/cards/labels:
    post:
      operationId: post_board_cards_labels
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                cardIds:
                  type: string
                  description: the cardIds value
              required:
              - cardIds
          application/json:
            schema:
              type: object
              properties:
                cardIds:
                  type: string
                  description: the cardIds value
              required:
              - cardIds
      summary: Post board cards labels
      x-summary-source: derived
  /api/boards/{board}/cardsByCustomField/{customField}/{customFieldValue}:
    get:
      operationId: get_board_customFieldValue
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: customField
        in: path
        description: the customField value
        required: true
        schema:
          type: string
      - name: customFieldValue
        in: path
        description: the customFieldValue value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get board custom field value
      x-summary-source: derived
  /api/boards/{board}/cards_count:
    get:
      operationId: get_board_cards_count
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get board cards count
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards:
    get:
      operationId: get_board_list_cards
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get board list cards
      x-summary-source: derived
    post:
      operationId: post_board_list_cards
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                linkedId:
                  type: string
                  description: the linkedId value
                dateField:
                  type: string
                  description: the dateField value
              required:
              - linkedId
              - dateField
          application/json:
            schema:
              type: object
              properties:
                linkedId:
                  type: string
                  description: the linkedId value
                dateField:
                  type: string
                  description: the dateField value
              required:
              - linkedId
              - dateField
      summary: Post board list cards
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/{card}:
    get:
      operationId: get_board_list_card
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get board list card
      x-summary-source: derived
    put:
      operationId: put_board_list_card
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                title:
                  type: string
                  description: the title value
                sort:
                  type: string
                  description: the sort value
                parentId:
                  type: string
                  description: the parentId value
                description:
                  type: string
                  description: the description value
                color:
                  type: string
                  description: the color value
                vote:
                  type: string
                  description: the vote value
                poker:
                  type: string
                  description: the poker value
                labelIds:
                  type: string
                  description: the labelIds value
                requestedBy:
                  type: string
                  description: the requestedBy value
                assignedBy:
                  type: string
                  description: the assignedBy value
                spentTime:
                  type: string
                  description: the spentTime value
                isOverTime:
                  type: string
                  description: the isOverTime value
                customFields:
                  type: string
                  description: the customFields value
                members:
                  type: string
                  description: the members value
                assignees:
                  type: string
                  description: the assignees value
                stickers:
                  type: string
                  description: the stickers value
                locations:
                  type: string
                  description: the locations value
              required:
              - title
              - sort
              - parentId
              - description
              - color
              - vote
              - poker
              - labelIds
              - requestedBy
              - assignedBy
              - spentTime
              - isOverTime
              - customFields
              - members
              - assignees
              - stickers
              - locations
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
                  description: the title value
                sort:
                  type: string
                  description: the sort value
                parentId:
                  type: string
                  description: the parentId value
                description:
                  type: string
                  description: the description value
                color:
                  type: string
                  description: the color value
                vote:
                  type: string
                  description: the vote value
                poker:
                  type: string
                  description: the poker value
                labelIds:
                  type: string
                  description: the labelIds value
                requestedBy:
                  type: string
                  description: the requestedBy value
                assignedBy:
                  type: string
                  description: the assignedBy value
                spentTime:
                  type: string
                  description: the spentTime value
                isOverTime:
                  type: string
                  description: the isOverTime value
                customFields:
                  type: string
                  description: the customFields value
                members:
                  type: string
                  description: the members value
                assignees:
                  type: string
                  description: the assignees value
                stickers:
                  type: string
                  description: the stickers value
                locations:
                  type: string
                  description: the locations value
              required:
              - title
              - sort
              - parentId
              - description
              - color
              - vote
              - poker
              - labelIds
              - requestedBy
              - assignedBy
              - spentTime
              - isOverTime
              - customFields
              - members
              - assignees
              - stickers
              - locations
      summary: Put board list card
      x-summary-source: derived
    delete:
      operationId: delete_board_list_card
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Delete board list card
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/{card}/archive:
    post:
      operationId: post_board_list_card_archive
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Post board list card archive
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/{card}/assignees/{assignee}:
    post:
      operationId: post_board_list_card_assignee
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      - name: assignee
        in: path
        description: the assignee value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Post board list card assignee
      x-summary-source: derived
    delete:
      operationId: delete_board_list_card_assignee
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      - name: assignee
        in: path
        description: the assignee value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Delete board list card assignee
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/{card}/copy:
    post:
      operationId: post_board_list_card_copy
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                toBoardId:
                  type: string
                  description: the toBoardId value
                toSwimlaneId:
                  type: string
                  description: the toSwimlaneId value
                toListId:
                  type: string
                  description: the toListId value
                position:
                  type: string
                  description: the position value
              required:
              - toBoardId
              - toSwimlaneId
              - toListId
              - position
          application/json:
            schema:
              type: object
              properties:
                toBoardId:
                  type: string
                  description: the toBoardId value
                toSwimlaneId:
                  type: string
                  description: the toSwimlaneId value
                toListId:
                  type: string
                  description: the toListId value
                position:
                  type: string
                  description: the position value
              required:
              - toBoardId
              - toSwimlaneId
              - toListId
              - position
      summary: Post board list card copy
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/{card}/customFields/{customField}:
    post:
      operationId: post_board_list_card_customField
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      - name: customField
        in: path
        description: the customField value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                value:
                  type: string
                  description: the value value
              required:
              - value
          application/json:
            schema:
              type: object
              properties:
                value:
                  type: string
                  description: the value value
              required:
              - value
      summary: Post board list card custom field
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/{card}/exportExcel:
    get:
      operationId: exportExcelCard
      summary: Export a single card to Excel (.xlsx), formatted for DIN A4 Portrait printing
      description: 'If user is already logged-in, pass loginToken as param

        "authToken": ''/api/boards/:boardId/lists/:listId/cards/:cardId/exportExcel?authToken=:token''


        Optional query param "fields" is a comma-separated list of sections to include.

        Valid values: people, board-info, dates, description, checklists, subtasks, comments

        Omitting "fields" includes all sections.'
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: 'the ID of the board

          '
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: 'the ID of the list

          '
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: 'the ID of the card to export

          '
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
  /api/boards/{board}/lists/{list}/cards/{card}/members/{member}:
    post:
      operationId: post_board_list_card_member
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      - name: member
        in: path
        description: the member value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Post board list card member
      x-summary-source: derived
    delete:
      operationId: delete_board_list_card_member
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      - name: member
        in: path
        description: the member value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Delete board list card member
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/{card}/unarchive:
    post:
      operationId: post_board_list_card_unarchive
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Post board list card unarchive
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards/bulk:
    post:
      operationId: post_board_list_cards_bulk
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                cards:
                  type: string
                  description: the cards value
              required:
              - cards
          application/json:
            schema:
              type: object
              properties:
                cards:
                  type: string
                  description: the cards value
              required:
              - cards
      summary: Post board list cards bulk
      x-summary-source: derived
  /api/boards/{board}/lists/{list}/cards_count:
    get:
      operationId: get_board_list_cards_count
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: list
        in: path
        description: the list value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get board list cards count
      x-summary-source: derived
  /api/boards/{board}/swimlanes/{swimlane}/cards:
    get:
      operationId: get_board_swimlane_cards
      tags:
      - Cards
      parameters:
      - name: board
        in: path
        description: the board value
        required: true
        schema:
          type: string
      - name: swimlane
        in: path
        description: the swimlane value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get board swimlane cards
      x-summary-source: derived
  /api/cards/{card}:
    get:
      operationId: get_card
      tags:
      - Cards
      parameters:
      - name: card
        in: path
        description: the card value
        required: true
        schema:
          type: string
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get card
      x-summary-source: derived
  /api/user/cards:
    get:
      operationId: get_user_cards
      tags:
      - Cards
      security:
      - UserSecurity: []
      responses:
        '200':
          description: 200 response
      summary: Get user cards
      x-summary-source: derived
  /api/boards/{boardId}/swimlanes/{swimlaneId}/lists/{listId}/ics:
    post:
      operationId: import_ics
      summary: Import an iCalendar (.ics) file into a board as cards
      description: 'Parses the supplied iCalendar text and creates one card per VEVENT on the

        given board / list / swimlane, populating each card''s `startAt` (DTSTART)

        and `dueAt` (DTEND, or DTSTART when there is no DTEND) so the imported

        events appear on the Calendar and Gantt views.


        Permissions: requires a valid auth token and write access to the board

        (read-only / comment-only / worker members are rejected; site admins are

        allowed).'
      tags:
      - Cards
      security:
      - UserSecurity: []
      parameters:
      - name: boardId
        in: path
        required: true
        description: the board ID
        schema:
          type: string
      - name: swimlaneId
        in: path
        required: true
        description: the swimlane ID the cards are created in
        schema:
          type: string
      - name: listId
        in: path
        required: true
        description: the list ID the cards are created in
        schema:
          type: string
      responses:
        '200':
          description: 'Import succeeded. Returns the number of cards created and their ids,

            e.g. `{ "created": 3, "cardIds": ["abc", "def", "ghi"] }`.

            '
        '400':
          description: Missing or empty `ics` body field
        '401':
          description: Missing or invalid authentication, or no write access to the board
        '404':
          description: Board, list or swimlane not found
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - ics
              properties:
                ics:
                  type: string
                  description: the raw .ics (iCalendar) file contents
        required: true
components:
  securitySchemes:
    UserSecurity:
      type: apiKey
      in: header
      name: Authorization
x-refined-from:
- wekan-meteor3-openapi.yml
- wekan-openapi.yml