templates

Start a flow from a template

Creates a new flow from the template and returns it, graph and all. Using a template is available on every plan; saving new ones is not.

post/v1/templates/{templateId}/flows

Request

  • Base URL: https://api.flowral.app
  • URL: https://api.flowral.app/v1/templates/{templateId}/flows
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (client credentials, token URL https://api.flowral.app/v1/oauth/token, scopes: flows:write, templates:read)

Path parameters

templateIdstring required

Request body

namestring

Defaults to the template's name.

dueDatestring

ISO 8601.

Response

CREATED

idstring required
namestring required
descriptionstring nullable
archivedboolean required
publicboolean

Whether this flow is published — readable by anyone with its link, with no account. Assignees, comments and files are never included in the public view.

publicUrlstring nullable

The published link, or null when the flow is private.

dueDatestring date-time

The date the flow is meant to land, if one is set.

taskCountinteger
doneCountinteger
readyCountinteger

Tasks that can be started right now.

createdAtstring date-time
updatedAtstring date-time

Example response

{
  "id": "flw_2b8e10",
  "publicUrl": "https://platform.flowral.app/public/flow/flw_2b8e10",
  "tasks": [
    {
      "id": "tsk_9f2c41"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.