v1

latestOpenAPI 3.0.32026-07-241112213.6 KB
Board Tasks

Batch Delete Tasks

Batch delete tasks from a Board. This is a synchronous operation. You can either delete specific tasks by ID list or delete all tasks matching filter criteria.

post/boards/tasks/batch-delete

Headers

Topview-Uidstring required

User ID

Authorizationstring required

API Key for authentication (Bearer token)

Request body

boardIdstring required

Board ID (required)

selectAllboolean

Whether to delete all matching tasks (true) or specific tasks (false, default). When true, filter must be provided and taskIds is ignored.

taskIdsstring[] nullable

Task ID list to delete. Required when selectAll=false. Ignored when selectAll=true.

excludeTaskIdsstring[] nullable

Task IDs to exclude from deletion. Only effective when selectAll=true. For tasks manually deselected by user.

Response

Tasks deleted successfully

codestring
messagestring
resultobject

Operation result containing deleted task count and status information

Example response

{
  "code": "200",
  "message": "Success"
}