Duplicate Workflow

POST

/api/v1/workflows/:workflow_id/duplicate

POST

/api/v1/workflows/:workflow_id/duplicate

$ curl -X POST https://api.onepin.ai/api/v1/workflows/workflow_id/duplicate \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "data": {
3     "id": "d4f1a2b3-9c8e-4f7a-8b2d-1a2b3c4d5e6f",
4     "user_id": "a1b2c3d4-e5f6-7a8b-9c0d-e1f2a3b4c5d6",
5     "name": "Monthly Report Generation (Copy)",
6     "definition": {
7       "edges": [
8         {
9           "from": "start",
10           "to": "generate_report"
11         },
12         {
13           "from": "generate_report",
14           "to": "send_email"
15         }
16       ],
17       "nodes": [
18         {
19           "config": {
20             "schedule": "0 8 1 * *"
21           },
22           "id": "start",
23           "type": "trigger"
24         },
25         {
26           "config": {
27             "script": "generate_report.py"
28           },
29           "id": "generate_report",
30           "type": "task"
31         },
32         {
33           "config": {
34             "email_template": "monthly_report"
35           },
36           "id": "send_email",
37           "type": "task"
38         }
39       ]
40     },
41     "created_at": "2024-01-15T09:30:00Z",
42     "updated_at": "2024-01-15T09:30:00Z",
43     "description": "Automates the generation and distribution of monthly sales reports.",
44     "runs_count": 0,
45     "last_run_at": null,
46     "last_run_status": null
47   },
48   "meta": {
49     "request_id": "7f8e9d6c-1234-4b56-8a9f-0b1c2d3e4f5a",
50     "timestamp": "2024-01-15T09:30:00Z"
51   }
52 }

Create a copy of an existing workflow in the same workspace.

The new workflow inherits the source’s name (suffixed with ” (Copy)”), description, and definition. Runs from the original workflow are not copied — the duplicate starts with zero runs. Requires at least editor role. Returns 201 with the new workflow on success.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error