Patch transforms

Replaces the Multi FileFeed's HEAD flowgraph with the supplied state.

The flowgraph.nodes and flowgraph.edges arrays represent the complete
desired state — nodes absent from the payload are deleted, and edges are
fully replaced. Every call must include a source node and an import or
import-v2 node or the request will be rejected. Represent the complete
workflow as a single graph.

Within an individual node, config uses merge semantics:

If a key is not specified, the current value is left unchanged.
If a key takes a scalar value

  • a supplied value replaces the current value
  • a null value deletes the key
    If a key takes an array value
  • supplied value replaces the current array
  • a null value deletes the key
    If a key takes a hash/object value
  • the supplied hash is recursively merged with the current hash (same rules apply at each nested level)
  • a null value deletes the key

Auto-commits by default. Use commit_now: false to defer committing.

Concurrency guards:

  • last_known_commit_id — optimistic lock; 409 if commits changed
  • Dirty-state check — 409 if HEAD has uncommitted UI edits (override with force: true)

Requires Multi FileFeed transforms to be enabled for the organization.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

ID of the Multi FileFeed

Body Params
integer
required

Payload format version (must be 1)

boolean
Defaults to true

Whether to auto-commit after applying (default true)

boolean
Defaults to false

Override dirty-state check when commit_now is true

integer

Optimistic lock — rejects if latest commit differs

workflow
object

Optional workflow-level metadata to update. Object-merge semantics:
only keys present are updated; absent keys leave current values
unchanged. workspace_key is read-only and ignored if supplied.

templates
array of objects

Optional full-replace list of template associations for this workflow.
When present, replaces all existing associations — entries absent from
the array are removed. Omit the field entirely to leave associations
unchanged.

templates
flowgraph
object
required
Responses

400

Bad request (invalid JSON or not an object)

401

Unauthorized

403

Forbidden (feature not enabled or wrong org)

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json