Remove a list item
Takes one item off a card's list.
An item that is not on the list is refused. Refused also when the list or the card changed since it was read.
Authorization
Authorization: Bearer <key> Authentication
Path parameters
The project's id.
The card's id.
The list item's id.
Body
An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused.
The list's revision as last read; when the list changed since, the change is refused.
The card's version as last read; when given and the card changed since, the change is refused.
Response
200 The list after the change.
The card's list.
Show properties of checklistHide properties of checklist
The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision.
The sets of items added together in one change.
Show properties of batchesHide properties of batches
The set's id, which each of its items names as batch.
The card's id.
The person who added the set, or null when no person did.
When the set was added.
The id of the change that added the set.
The list's items, in their order.
Show properties of itemsHide properties of items
The item's id.
The item's place in the list, from 0.
The id of the set the item was added in, or null when it was added on its own.
The item's text, as written.
The text in the reader's language, when it is written in another.
Show properties of translationHide properties of translation
The reader's language the text is translated into.
ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now.
The translated text, present once ready.
True when the item is checked.
When the item was checked, or null while it is not.
Who checked the item, or null while it is not checked.
Show properties of checkedByHide properties of checkedBy
One of 3 shapes, told apart by kind:
kinduseruser for a person; connector or schedule for a change Werk made without one.
The person's name as the project shows it.
The person's initials, for an avatar with no photo.
True when the person is the key's own person.
The person's photo, when they have one.
Show properties of photoHide properties of photo
The person whose photo it is.
The photo's version, which changes with the photo; its read takes it to fetch the current one.
The connected app or API key the change came through; absent for a change made in Werk's apps.
Show properties of viaHide properties of via
connection for an app connected by sign-in, key for an API key.
The app's or the key's name, as Werk shows it.
True when Werk verified the app's identity.
The caption Werk shows beside the change, in the reader's language.
kindconnectoruser for a person; connector or schedule for a change Werk made without one.
The name Werk shows for a change made without a person.
kindscheduleuser for a person; connector or schedule for a change Werk made without one.
The name Werk shows for a change made without a person.
The list's items checked and in all.
Show properties of countsHide properties of counts
List items checked.
List items in all.
Errors
invalid_query The query is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).invalid_checklist_request The list request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).empty_text The text is empty once trimmed.text_too_long The text has more characters than its field holds.session_revoked The request carries no session the server holds, or its session has ended.session_expired The session has expired.actor_not_allowed The signed-in person may not make this change to the card.not_permitted The signed-in person's role, or whose the record is, does not allow this request.conversation_not_found The project the request names, or its chat, is not one the signed-in person is in.item_not_found The card the request names, or its list, is not one the signed-in person can see.session_changed The session changed while the request was in flight.project_deleted The project is being deleted.project_archived The project is archived, so it does not take this request.request_conflict The request id was already used with another request, or the change it asks could not be made to the record it names.request_erased The request id belongs to a request whose record was erased.item_version_conflict The card changed after the version the request names.card_archived The card is archived, so it does not take this change.rate_limited More requests of this kind were sent than Werk takes within the time it counts them over.server_error The server could not complete the request, and it is not known whether a write it holds was made.curl -X DELETE "https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/cards/1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81/list/entries/b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39" \
-H "Authorization: Bearer wk_key_..." \
-H "Content-Type: application/json" \
-d '{
"clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f19",
"expectedRevision": 3
}'const res = await fetch("https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/cards/1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81/list/entries/b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39", {
method: "DELETE",
headers: {
Authorization: "Bearer wk_key_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f19",
"expectedRevision": 3
}),
});
const answer = await res.json();{
"checklist": {
"revision": 4,
"batches": [
{
"id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
"itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
"authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
"createdAt": "2026-11-19T16:10:00.000Z",
"groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
}
],
"items": [
{
"id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
"position": 0,
"batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
"text": "Shut off the water under the sink",
"checked": true,
"checkedAt": "2026-11-19T16:20:00.000Z",
"checkedBy": {
"kind": "user",
"displayName": "Tom Okafor",
"initials": "TO",
"isViewer": false
}
}
],
"counts": {
"done": 1,
"total": 1
}
}
}Send a requestDELETE
It is sent with the key you give, as you. A change made here is real.
The request could not be sent, or its response could not be read.