organize
Put several items online or offline
/api/v1/bulk/online
Apply the setting to each item the account may edit and whose setting differs; the others are skipped. changed lists every binder and flow whose status moved, what the binders hold included.
key
Required scope: publish
Request body application/json
-
itemsarray of Item · requiredWhat to act on.
2 fields
-
typestring · requiredWhat it is.
-
idinteger · requiredIts id.
-
-
onlineboolean · requiredtrueto open them to their readers,falseto close them.
Response
200
BulkOnlineDone
-
appliedintegerNumber of items the setting was applied to.
-
changedarray of StatusChangeEvery binder and flow whose status moved, what the binders hold included.
3 fields
-
typestringWhat it is.
-
idintegerIts id.
-
online_statusstringonline: open to its readers.offline: closed.pending_online/pending_offline: inside a binder that is not online, hence closed; the setting is recorded and applies when the parent goes online.
-
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.