> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://onepin.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://onepin.ai/docs/_mcp/server.

# Use templates

Templates are pre-built pipelines. Clone one into your workspace to get an editable, runnable workflow. Cloning requires the `workflows:write` scope.

## Browse and clone

#### Python

```python
from onepin import OnepinClient

client = OnepinClient()

for t in client.templates.list(limit=50).data:
    print(t.id, t.name, "⭐" if t.is_starter else "")

workflow_id = client.templates.clone(template_id, name="My first workflow").data.id
```

#### CLI

```bash
onepin templates list

WF=$(onepin templates clone "$TEMPLATE_ID" --name "My first workflow" --json | jq -r '.id')
```

The clone always uses the template's **published** definition. The new workflow is created but not run — start it with [Run a workflow](/docs/guides/run-a-workflow).

`name` is optional: omit it and the new workflow takes the template's own name. Workflow names aren't unique within a workspace, so cloning the same template twice succeeds and leaves you with two workflows sharing a name — pass `name` if you care about telling them apart.

## Related

* [Run a workflow](/docs/guides/run-a-workflow) — run the cloned workflow
* [Quickstart](/docs/get-started/quickstart) — clone → run → download end to end