organize
Duplicate a flow
/api/v1/flows/{flow_id}/duplicate
Copy a flow with its steps and buttons. 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
-
flow_idinteger · requiredId of the flow.
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
Flow
-
idintegerId, unique among the objects of its type.
-
typestringAlways
flow. -
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.
-
is_publishedbooleanWhether a published version exists.
-
published_atdate-time or nullWhen it was last published;
nullwhen it never was. -
has_unpublished_changesboolean or nullWhether the draft differs from the published version.
nullfor who may not edit the flow.
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.