Skip to main content
POST
Clone a workflow
You run only your own workflows and your workspaces’. To run a public workflow, clone it first. Find one with a marketplace search, and read it with Get a workflow. The copy is a private draft, it is yours, and it keeps a link to the original. Cloning is free. The answer is the copy as Get a workflow shows it, plus cloned_from, the slug of the original. The copy has its own slug. Run it with that slug, for example with Run a workflow and wait. A workflow you may not see answers 404. Needs workflows:invoke or workflows:write. A key with neither gets 403. MCP tool: clone_workflow.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Headers

Idempotency-Key
string

Any unique string (such as your order id). Resending the same request with the same key within 24 hours returns the first answer (with Idempotent-Replayed: true) and does nothing twice; the same key with a different request is a 422 idempotency_key_reused.

Required string length: 1 - 255

Path Parameters

slug
string
required

Response

Your copy of the workflow.

POST /v1/workflows/{slug}/clone: your new copy, as GET /v1/workflows/{slug} shows it.

id
string
required
slug
string
required
name
string
required
api_endpoint
string
required
runs_endpoint
string
required
run_status_endpoint
string
required
mcp_tool
string
required
cloned_from
string
required

The slug of the workflow this is a copy of

description
string | null
status
string | null
input_schema
Input Schema · object[]
input_json_schema
Input Json Schema · object
output
string
default:""
output_json_schema
Output Json Schema · object
run_json_schema
Run Json Schema · object
trigger
Trigger · object
reliability
Reliability · object
steps
Steps · object[] | null

The graph's steps (on create, change and GET with include_graph=true).

connections
Connections · object[] | null
version
integer | null

How many saved versions came before this one.