Items

Move items onto another list

Move items onto another list: a task out to the Tasks list ("tasks"), a note onto the Notes list ("notes"), anything onto a list by id. Each item keeps its id, body, chat and history; its values follow their properties by id, then by name and type, select values by label. A value the destination list has no place for would be DROPPED: a first call that would drop values answers a preview (preview: true, droppedValues) and moves nothing; the same call with acknowledgeDataLoss: true then moves. The status and due date ride along unseen onto a list that keeps neither and show again on the way back. An item inside a list shared with the user moves as far as the app lets them: out onto one of their own lists (it becomes theirs, and everyone in the shared list loses it), or into another shared list they are in; such a move changes who can reach the item, so the first call answers a preview (accessChanges, the app's own question) and moves nothing until the repeat with acknowledgeDataLoss: true. An item shared with the user one item at a time stays its owner's to move: it is reported under refused with the reason, never moved.

post/api/v1/items/move

Request

  • Base URL
    https://api.roma.app
  • URL
    https://api.roma.app/api/v1/items/move
  • Auth
    HTTP bearer

Request body

itemIdsstring[] required

Ids of the items to move.

listIdstring required

The destination list: a list id (from list_lists or get_context), or the word "tasks" (the Tasks list, the unsorted pool) or "notes" (the Notes list, made afresh when the user deleted theirs).

acknowledgeDataLossboolean nullable

true ONLY on a repeat call, after a preview reported values the destination list has no place for, or people who will gain or lose access, and you told the user what will happen.

Response

The tool's result.

previewboolean
listIdstring
listNamestring nullable
refusedstring[]

Changes

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