Skip to main content
DELETE
Delete a task
Write access: a member/administrator with a write-enabled credential, or an authorized signed-in user. Permanently delete a task and its discussion. Confirm with the user before deleting their work. Permanently removes the task, discussion, activity and notifications, and queues attachment cleanup. Task numbers are not reused. Without the same retry key a repeated delete returns 404. MCP clients can use delete_task for this operation. Request conventions · API keys · MCP connections

Authorizations

Authorization
string
header
required

Personal or team Mill REST API key

Headers

Origin
string<uri>

The exact configured Mill UI origin. Required for browser mutations carrying session cookies.

Idempotency-Key
string

Reuse the same key and exact request bytes for retries of one logical mutation; different content conflicts.

Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

taskId
string<uuid>
required

The taskId from the corresponding list, record or authorization response.

Body

application/json
version
integer
required
Required range: x <= 9007199254740991

Response

Successful response. Examples are illustrative; field values vary by record.

Illustrative response shape. Fields can be absent in alternate successful flows; see the operation description and example.

ok
boolean