Clone Template

POST

/api/v1/templates/:template_id/clone

POST

/api/v1/templates/:template_id/clone

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

1 {
2   "data": {
3     "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4     "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
5     "name": "Marketing Campaign Workflow (Copy)",
6     "definition": {},
7     "created_at": "2024-01-15T09:30:00Z",
8     "updated_at": "2024-01-15T09:30:00Z",
9     "description": "Cloned workflow for the Q2 marketing campaign automation.",
10     "runs_count": 12,
11     "last_run_at": "2024-04-10T14:45:00Z",
12     "last_run_status": "completed"
13   },
14   "meta": {
15     "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
16     "timestamp": "2024-04-11T08:00:00Z"
17   }
18 }

Clone a template into a workflow in the caller’s workspace.

Dual-auth: Clerk JWT or op_live_* API key (scope workflows:write).

Same-workspace clones use the live definition (owner authoring). Cross-workspace clones use the published_definition snapshot to avoid leaking unpublished draft edits.

Resolved name: explicit body.name (stripped) OR fallback to "{source_name} (Copy)".

Clone a template into a workflow in the caller's workspace. Dual-auth: Clerk JWT or `op_live_*` API key (scope `workflows:write`). Same-workspace clones use the live `definition` (owner authoring). Cross-workspace clones use the `published_definition` snapshot to avoid leaking unpublished draft edits. Resolved name: explicit `body.name` (stripped) OR fallback to `"{source_name} (Copy)"`.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

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

Path parameters

template_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

namestring or nullOptional<=200 characters

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error

Authentication

Path parameters

Headers

Request

Response

Errors