Import a flow bundle

post

https://api.doit.com/cloudflow/v1/flows/actions/import

Creates every flow of a previously exported bundle in the authenticated tenant.
Imports are create-only: each call creates new draft flows with new IDs — nothing is
published and no schedule is activated until the target tenant publishes.

Requirements declared by the bundle are resolved through bindings (requirement key →
target-tenant resource ID). Unbound connections and Datastore tables leave the
referencing nodes flagged incomplete; unbound global variables are auto-created. Pass
options.createMissingTables: true to create missing Datastore tables from the schemas
embedded in the bundle (structure only, never row data).

Dry-run: pass ?dryRun=true to validate without writing. The response is an import
plan: per-requirement resolutions with candidate bindings in the target tenant, the
flows that would be created, and every validation issue at once.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

dryRun

boolean

Defaults to false

If true, validates the bundle and resolves its requirements against the tenant
without committing changes, returning the import plan.

Body Params

bundle

object

required

Portable, tenant-neutral export of one or more flows. Contains no credentials, tenant identifiers, schedules, or execution state; tenant-scoped references are declared under requirements and appear inside node parameters as $req:<section>/<key> tokens (subflow references as $bundle:flows/<flowKey>).

bindings

object

Requirement key → target-tenant resource ID. Keys must be declared in the bundle's requirements. Run with ?dryRun=true first to list required keys and candidate IDs.

options

object

Headers

Idempotency-Key

string

required

length ≤ 255

Client-generated idempotency key (UUID v4 or ULID recommended, max 255 characters).
Re-submitting the same key with the same request returns the cached response without
re-executing side effects. The server retains the key for at least 24 hours.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Dry-run import plan (no writes performed).

201Every flow in the bundle was created.

400Syntactically malformed request, missing required parameter, or unsupported parameter value.

401Missing or invalid credentials.

403Authenticated but not authorized to access this customer's PerfectScale for Commitments resources.

422Unprocessable Entity - The request is well-formed but semantically invalid.

500Unexpected server error.