v1

latestOpenAPI 3.0.32026-08-0621531.1 KB

List items

Import list items

Imports list items (in the format supported by Checkvist's import function), organised into a hierarchy according to the input. Items are added to the beginning of the target list. Returns the created items.

post/checklists/{checklist_id}/import.{format}

Path parameters

checklist_idstring required

Target list ID. May also be tag:tagname — the first list tagged with tagname is used.

format'json' | 'xml' required

Response representation.

Response

The created list items.

idinteger

contentstring

Task content.

status0 | 1 | 2

0 - open, 1 - closed, 2 - invalidated.

checklist_idinteger

Containing checklist ID.

parent_idinteger

Parent task ID. Empty for root-level items in XML, or 0 in JSON.

comments_countinteger

Number of notes for this item.

positioninteger

1-based position under its parent.

priorityinteger

(JSON only) Optional task priority, 1..9.

duestring

Due date, when set.

deletedboolean

Present (and true) only in the representation of a just-deleted item.

assignee_idsinteger[]

(JSON only) IDs of the item's assignees.

tasksinteger[]

(JSON only) Child task IDs.

tagsobject

(JSON only) Map of tag name => isPrivate. When modifying an item, both a map and a comma-separated string of tag names are accepted.

tags_as_textstring

(JSON only) Comma-separated list of tag names. Also accepted when modifying an item.

update_linestring

(JSON only) Text describing the last change, e.g. 'updated by kir'.

updated_atstring

(JSON only) Time of the last change. See Timestamp format in the introduction.

created_atstring

(JSON only) When the item was created. See Timestamp format in the introduction.