organize
Move binders and flows
/api/v1/move
Move items into a binder (target: its id), to the root of your own space (root) or of an organisation (org:<id>).
A move that would close content to its readers, change who it is shared with or make it public is not done at once: it answers 409 confirmation_required with what would change, and is to be sent again with confirmed: true. Items that cannot be moved are skipped and counted in ignored.
key
Required scope: write
Request body application/json
-
itemsarray of Item · requiredWhat to move.
2 fields
-
typestring · requiredWhat it is.
-
idinteger · requiredIts id.
-
-
targetstring · requiredWhere to: the id of a binder,
root(the root of your own space) ororg:<id>(the root of an organisation). -
confirmedboolean · optionalSet to
trueto go through with a move that answeredconfirmation_required.
Response
200
Moved
-
movedarray of ItemWhat was moved.
2 fields
-
typestringWhat it is.
-
idintegerIts id.
-
-
ignoredintegerNumber of items left where they were: not found, or not movable there.
-
now_onlineintegerNumber of items the move opened to their readers.
Errors
-
401
No valid credential.
-
403
The credential lacks the required scope, or the account may not do this.
-
409
The current state of the content forbids the request.
-
422
A value is missing or malformed.
-
429
Too many requests;
Retry-Aftergives the seconds to wait.