Flows

Fork Flow

Changed on

Create an inert copy of a flow, optionally carrying a caller-supplied graph.

Read access is deliberately enough: anyone who can open a flow can already export it and import the result, so requiring write here would block the conflict dialog's only exit without protecting anything. The copy is owned by whoever forked it and inherits no exposure from the source.

post/api/v1/flows/{flow_id}/fork

Request

  • The document declares no server URL.
  • Auth
    • OAuth 2
      Password
      Token URL: api/v1/login
    • or API key in query parameter x-api-key
    • or API key in header x-api-key

Path parameters

flow_idstring uuid required

Request body

dataobject nullable

Graph for the copy; the source graph when omitted

namestring nullable

Name for the copy; the source name plus a suffix by default

Response

Successful Response

a2a_card_overridesobject nullable

User overrides for the generated A2A agent card (skill description, examples, tags)

a2a_enabledboolean nullable

Can be exposed as an A2A agent (only meaningful when flow_type=agent)

access_type'PRIVATE' | 'PUBLIC'
action_descriptionstring nullable

The description of the action associated with the flow

action_namestring nullable

The name of the action associated with the flow

dataobject nullable
descriptionstring nullable
endpoint_namestring nullable
flow_type'workflow' | 'agent'
folder_idstring uuid nullable required
gradientstring nullable
iconstring nullable
icon_bg_colorstring nullable
idstring uuid required
is_componentboolean nullable
lockedboolean nullable
mcp_enabledboolean nullable

Can be exposed in the MCP server

namestring required
name_keystring nullable

Stable i18n key derived from the original English name

tagsstring[] nullable

The tags of the flow

updated_atstring date-time nullable
user_idstring uuid nullable required
version_tokenstring uuid nullable

Token identifying the version this response carries

webhookboolean nullable

Can be used on the webhook endpoint

workspace_idstring uuid nullable

Changes