---
title: "Create a Workflow from Template"
method: POST
path: "/v1/workflows/from-template"
tags: ["Workflows API"]
---

# Create a Workflow from Template

`POST /v1/workflows/from-template`

Use this endpoint to create a new workflow from a catalog template. The template parameters are validated against the template's JSON Schema. The new workflow is created in `draft` status.

## Request body

- CreateWorkflowFromTemplateInput
  - `templateId` string, required — Identifier of the catalog template to use.
  - `params` object, required — Template parameter values used to generate the workflow.

## Response `201`

Indicates that the resource was successfully created and the operation was completed as expected.

- WorkflowCreateOutput
  - `createdAt` string, date-time — Timestamp when the workflow was created.
  - `status` string — Initial status of the workflow (always `draft` on creation).
  - `version` string — Version of the workflow definition.
  - `workflowId` string, uuid — Unique identifier of the created workflow.

## Other responses

- `400` — Indicates that the request was malformed or contained invalid parameters.
- `404` — Indicates that the requested resource could not be found.
- `409` — Indicates that the request could not be completed due to a conflict with the current state of the resource.
- `500` — Indicates an unexpected internal error. If this persists, please contact support.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)