Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/tailor-platform/sdk/llms.txt

Use this file to discover all available pages before exploring further.

Commands for managing workflows and workflow executions.

workflow

Manage workflows and workflow executions. Usage
tailor-sdk workflow [command]
Commands
CommandDescription
workflow listList all workflows in the workspace
workflow getGet workflow details
workflow startStart a workflow execution
workflow executionsList or get workflow executions
workflow resumeResume a failed or pending workflow execution

workflow list

List all workflows in the workspace. Usage
tailor-sdk workflow list [options]
Options
OptionAliasDescriptionRequiredDefault
--json-jOutput as JSONNofalse
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-
--profile <PROFILE>-pWorkspace profileNo-

workflow get

Get workflow details by name. Usage
tailor-sdk workflow get [options] <name>
Arguments
ArgumentDescriptionRequired
nameWorkflow nameYes
Options
OptionAliasDescriptionRequiredDefault
--json-jOutput as JSONNofalse
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-
--profile <PROFILE>-pWorkspace profileNo-

workflow start

Start a workflow execution. Usage
tailor-sdk workflow start [options] <name>
Arguments
ArgumentDescriptionRequired
nameWorkflow nameYes
Options
OptionAliasDescriptionRequiredDefault
--json-jOutput as JSONNofalse
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-
--profile <PROFILE>-pWorkspace profileNo-
--config <CONFIG>-cPath to SDK config fileNo"tailor.config.ts"
--machineuser <MACHINEUSER>-mMachine user nameYes-
--arg <ARG>-aWorkflow argument (JSON string)No-
--wait-WWait for execution to completeNofalse
--interval <INTERVAL>-iPolling interval when using —wait (e.g., ‘3s’, ‘500ms’, ‘1m’)No"3s"
--logs-lDisplay job execution logs after completion (requires —wait)Nofalse
Examples Start a workflow:
tailor-sdk workflow start my-workflow -m admin-machine-user
Start with argument:
tailor-sdk workflow start my-workflow -m admin -a '{"userId": "123"}'
Start and wait for completion:
tailor-sdk workflow start my-workflow -m admin -W
Start, wait, and display logs:
tailor-sdk workflow start my-workflow -m admin -W -l

workflow executions

List or get workflow executions. Usage
tailor-sdk workflow executions [options] [executionId]
Arguments
ArgumentDescriptionRequired
executionIdExecution ID (if provided, shows details)No
Options
OptionAliasDescriptionRequiredDefault
--json-jOutput as JSONNofalse
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-
--profile <PROFILE>-pWorkspace profileNo-
--workflow-name <WORKFLOW_NAME>-nFilter by workflow name (list mode only)No-
--status <STATUS>-sFilter by status (list mode only)No-
--wait-WWait for execution to completeNofalse
--interval <INTERVAL>-iPolling interval when using —wait (e.g., ‘3s’, ‘500ms’, ‘1m’)No"3s"
--logs-Display job execution logs (detail mode only)Nofalse
Examples List all executions:
tailor-sdk workflow executions
Filter by workflow name:
tailor-sdk workflow executions -n my-workflow
Filter by status:
tailor-sdk workflow executions -s RUNNING
Get execution details:
tailor-sdk workflow executions <execution-id>
Get execution details with logs:
tailor-sdk workflow executions <execution-id> --logs
Wait for execution to complete:
tailor-sdk workflow executions <execution-id> -W

workflow resume

Resume a failed or pending workflow execution. Usage
tailor-sdk workflow resume [options] <executionId>
Arguments
ArgumentDescriptionRequired
executionIdFailed execution IDYes
Options
OptionAliasDescriptionRequiredDefault
--json-jOutput as JSONNofalse
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-
--profile <PROFILE>-pWorkspace profileNo-
--wait-WWait for execution to completeNofalse
--interval <INTERVAL>-iPolling interval when using —wait (e.g., ‘3s’, ‘500ms’, ‘1m’)No"3s"
--logs-lDisplay job execution logs after completion (requires —wait)Nofalse
Examples Resume a failed execution:
tailor-sdk workflow resume <execution-id>
Resume and wait for completion:
tailor-sdk workflow resume <execution-id> -W
Resume, wait, and display logs:
tailor-sdk workflow resume <execution-id> -W -l

Build docs developers (and LLMs) love