Lists

Move cards

Moves all cards from a closed list to an archive list. Requires board editor permissions.

post/lists/{id}/move-cards

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/lists/{id}/move-cards
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Path parameters

idstring required
Example:1357158568008091264

ID of the source list (must be a closed-type list)

Request body

listIdstring required

ID of the target list (must be an archive-type list)

Example request

{
  "listId": "1357158568008091265"
}

Response

Cards moved successfully

Example response

{
  "item": {
    "id": "1357158568008091264",
    "boardId": "1357158568008091265",
    "type": "active",
    "position": 65536,
    "name": "To Do",
    "color": "lagoon-blue",
    "createdAt": "2024-01-01T00:00:00.000Z",
    "updatedAt": "2024-01-01T00:00:00.000Z"
  },
  "included": {
    "cards": [
      {
        "id": "1357158568008091264",
        "boardId": "1357158568008091265",
        "listId": "1357158568008091266",
        "creatorUserId": "1357158568008091267",
        "prevListId": "1357158568008091268",
        "coverAttachmentId": "1357158568008091269",
        "type": "project",
        "position": 65536,
        "name": "Implement user authentication",
        "description": "Add JWT-based authentication system...",
        "dueDate": "2024-01-01T00:00:00.000Z",
        "stopwatch": {
          "startedAt": "2024-01-01T00:00:00.000Z",
          "total": 3600
        },
        "commentsTotal": 100,
        "listChangedAt": "2024-01-01T00:00:00.000Z",
        "createdAt": "2024-01-01T00:00:00.000Z",
        "updatedAt": "2024-01-01T00:00:00.000Z"
      }
    ],
    "actions": [
      {
        "id": "1357158568008091264",
        "boardId": "1357158568008091265",
        "cardId": "1357158568008091266",
        "userId": "1357158568008091267",
        "type": "moveCard",
        "data": {
          "card": {
            "name": "Implement user authentication"
          },
          "toList": {
            "id": "1357158568008091268",
            "name": "To Do",
            "type": "active"
          },
          "fromList": {
            "id": "1357158568008091269",
            "name": "Done",
            "type": "closed"
          }
        },
        "createdAt": "2024-01-01T00:00:00.000Z",
        "updatedAt": "2024-01-01T00:00:00.000Z"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.