Skip to main content
POST
/
v1
/
workflows
/
from-template
Create a Workflow from Template
curl --request POST \
  --url https://flowker.sandbox.lerian.net/v1/workflows/from-template \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "templateId": "payment-validation",
  "params": {
    "executorId": "a1b2c3d4-e5f6-4789-a012-345678901234",
    "currency": "USD"
  }
}
'
{
  "createdAt": "2026-03-17T14:30:00Z",
  "status": "draft",
  "version": "1.0.0",
  "workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Authorizations

​
X-API-Key
string
header
required

API key for authenticating requests to the Flowker API. Provisioned via the API_KEY environment variable during deployment.

Body

application/json

Request body containing the template ID and parameters.

​
templateId
string
required

Identifier of the catalog template to use.

Example:

"payment-validation"

​
params
object
required

Template parameter values used to generate the workflow.

Example:
{
  "executorId": "a1b2c3d4-e5f6-4789-a012-345678901234",
  "currency": "USD"
}

Response

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

​
createdAt
string<date-time>

Timestamp when the workflow was created.

Example:

"2026-03-17T14:30:00Z"

​
status
string

Initial status of the workflow (always draft on creation).

Example:

"draft"

​
version
string

Version of the workflow definition.

Example:

"1.0.0"

​
workflowId
string<uuid>

Unique identifier of the created workflow.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"