Developers API reference Version 1 · generated from the code openapi.json
Routes

organize

Duplicate a flow

POST /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.

Required scope: write

Path parameters

  • flow_id integer · required

    Id of the flow.

Request body application/json

  • target string or null · optional

    Where to: the id of a binder, root (the root of your own space) or org:<id> (the root of an organisation).

  • name string or null · optional

    Name of the copy, 1 to 200 characters. Left out: the name of the original, marked as a copy.

Response

201 Flow

  • id integer

    Id, unique among the objects of its type.

  • type string

    Always flow.

  • name string

    Its name.

  • role string or null

    Role of the account on it: owner, editor or reader; null when it holds none of its own.

  • online_status string

    online: 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_id integer or null

    Id of the binder that holds it; null at the root of a space.

  • organisation_id integer or null

    Id of the organisation whose space it lives in; null in a personal space.

  • owner Owner

    The account that owns it.

    2 fields
    • id integer

      Id of the account.

    • name string

      Its name, or its address when it has none.

  • created_at date-time

    When it was created.

  • updated_at date-time

    When it was last changed.

  • is_published boolean

    Whether a published version exists.

  • published_at date-time or null

    When it was last published; null when it never was.

  • has_unpublished_changes boolean or null

    Whether the draft differs from the published version. null for 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-After gives the seconds to wait.

planner_banner_ad_pt