Workflow Commands
Commands for managing workflows and workflow executions.
workflow
Manage workflows and workflow executions.
Usage
tailor-sdk workflow [command]
Commands
| Command | Description |
|---|---|
workflow list | List all workflows in the workspace. |
workflow get | Get workflow details. |
workflow start | Start a workflow execution. |
workflow executions | List or get workflow executions. |
workflow resume | Resume a failed or pending workflow execution. |
workflow list
List all workflows in the workspace.
Usage
tailor-sdk workflow list [options]
Options
| Option | Alias | Description | Required | Default |
|---|---|---|---|---|
--json | -j | Output as JSON | No | false |
--workspace-id <WORKSPACE_ID> | -w | Workspace ID | No | - |
--profile <PROFILE> | -p | Workspace profile | No | - |
workflow get
Get workflow details.
Usage
tailor-sdk workflow get [options] <name>
Arguments
| Argument | Description | Required |
|---|---|---|
name | Workflow name | Yes |
Options
| Option | Alias | Description | Required | Default |
|---|---|---|---|---|
--json | -j | Output as JSON | No | false |
--workspace-id <WORKSPACE_ID> | -w | Workspace ID | No | - |
--profile <PROFILE> | -p | Workspace profile | No | - |
workflow start
Start a workflow execution.
Usage
tailor-sdk workflow start [options] <name>
Arguments
| Argument | Description | Required |
|---|---|---|
name | Workflow name | Yes |
Options
| Option | Alias | Description | Required | Default |
|---|---|---|---|---|
--json | -j | Output as JSON | No | false |
--workspace-id <WORKSPACE_ID> | -w | Workspace ID | No | - |
--profile <PROFILE> | -p | Workspace profile | No | - |
--config <CONFIG> | -c | Path to SDK config file | No | "tailor.config.ts" |
--machineuser <MACHINEUSER> | -m | Machine user name | Yes | - |
--arg <ARG> | -a | Workflow argument (JSON string) | No | - |
--wait | -W | Wait for execution to complete | No | false |
--interval <INTERVAL> | -i | Polling interval when using --wait (e.g., '3s', '500ms', '1m') | No | "3s" |
--logs | -l | Display job execution logs after completion (requires --wait) | No | false |
workflow executions
List or get workflow executions.
Usage
tailor-sdk workflow executions [options] [executionId]
Arguments
| Argument | Description | Required |
|---|---|---|
executionId | Execution ID (if provided, shows details) | No |
Options
| Option | Alias | Description | Required | Default |
|---|---|---|---|---|
--json | -j | Output as JSON | No | false |
--workspace-id <WORKSPACE_ID> | -w | Workspace ID | No | - |
--profile <PROFILE> | -p | Workspace profile | No | - |
--workflow-name <WORKFLOW_NAME> | -n | Filter by workflow name (list mode only) | No | - |
--status <STATUS> | -s | Filter by status (list mode only) | No | - |
--wait | -W | Wait for execution to complete | No | false |
--interval <INTERVAL> | -i | Polling interval when using --wait (e.g., '3s', '500ms', '1m') | No | "3s" |
--logs | - | Display job execution logs (detail mode only) | No | false |
workflow resume
Resume a failed or pending workflow execution.
Usage
tailor-sdk workflow resume [options] <executionId>
Arguments
| Argument | Description | Required |
|---|---|---|
executionId | Failed execution ID | Yes |
Options
| Option | Alias | Description | Required | Default |
|---|---|---|---|---|
--json | -j | Output as JSON | No | false |
--workspace-id <WORKSPACE_ID> | -w | Workspace ID | No | - |
--profile <PROFILE> | -p | Workspace profile | No | - |
--wait | -W | Wait for execution to complete | No | false |
--interval <INTERVAL> | -i | Polling interval when using --wait (e.g., '3s', '500ms', '1m') | No | "3s" |
--logs | -l | Display job execution logs after completion (requires --wait) | No | false |
Usage Examples:
<span><span style="color: var(--shiki-token-comment)"># Start a workflow</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">start</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-m</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">admin-machine-user</span></span>
<span></span>
<span><span style="color: var(--shiki-token-comment)"># Start with argument</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">start</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-m</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">admin</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-a</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">'{"userId": "123"}'</span></span>
<span></span>
<span><span style="color: var(--shiki-token-comment)"># Start and wait for completion</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">start</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-m</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">admin</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-W</span></span>
<span></span>
Usage Examples:
<span><span style="color: var(--shiki-token-comment)"># List all executions</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executions</span></span>
<span></span>
<span><span style="color: var(--shiki-token-comment)"># Filter by workflow name</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executions</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-n</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-workflow</span></span>
<span></span>
<span><span style="color: var(--shiki-token-comment)"># Filter by status</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executions</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-s</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">RUNNING</span></span>
<span></span>
<span><span style="color: var(--shiki-token-comment)"># Get execution details</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executions</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)"><</span><span style="color: var(--shiki-token-string)">execution-i</span><span style="color: var(--shiki-color-text)">d</span><span style="color: var(--shiki-token-keyword)">></span></span>
<span></span>
<span><span style="color: var(--shiki-token-comment)"># Get execution details with logs</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executions</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)"><</span><span style="color: var(--shiki-token-string)">execution-i</span><span style="color: var(--shiki-color-text)">d</span><span style="color: var(--shiki-token-keyword)">></span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">--logs</span></span>
<span></span>
<span><span style="color: var(--shiki-token-comment)"># Wait for execution to complete</span></span>
<span><span style="color: var(--shiki-token-function)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">workflow</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executions</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)"><</span><span style="color: var(--shiki-token-string)">execution-i</span><span style="color: var(--shiki-color-text)">d</span><span style="color: var(--shiki-token-keyword)">></span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-W</span></span>
<span></span>