organize
Duplicate a binder
/api/v1/binders/{binder_id}/duplicate
Copy a binder with everything it holds. The copy is offline, shared with no one and owned by the account.
Without target it lands next to the original when the account may create there, otherwise at the root of its space.
key
Required scope: write
Path parameters
-
binder_idinteger · requiredId of the binder.
Request body application/json
-
targetstring or null · optionalWhere to: the id of a binder,
root(the root of your own space) ororg:<id>(the root of an organisation). -
namestring or null · optionalName of the copy, 1 to 200 characters. Left out: the name of the original, marked as a copy.
Response
201
Binder
-
idintegerId, unique among the objects of its type.
-
typestringAlways
binder. -
namestringIts name.
-
rolestring or nullRole of the account on it:
owner,editororreader;nullwhen it holds none of its own. -
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. -
parent_idinteger or nullId of the binder that holds it;
nullat the root of a space. -
organisation_idinteger or nullId of the organisation whose space it lives in;
nullin a personal space. -
ownerOwnerThe account that owns it.
2 fields
-
idintegerId of the account.
-
namestringIts name, or its address when it has none.
-
-
created_atdate-timeWhen it was created.
-
updated_atdate-timeWhen it was last changed.
-
descriptionstringFree text; may be empty.
-
flows_countinteger or nullNumber of flows directly inside. Given in listings,
nullelsewhere. -
sub_binders_countinteger or nullNumber of binders directly inside. Given in listings,
nullelsewhere.
Errors
-
401
No valid credential.
-
403
The credential lacks the required scope, or the account may not do this.
-
404
Nothing with that id, or nothing the account may open.
-
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.