Executor Commands

Commands for managing executors and executor jobs.

executor

Manage executors

Usage

tailor-sdk executor [command]

Commands

Command	Description
`executor list`	List all executors
`executor get`	Get executor details
`executor jobs`	List or get executor jobs.
`executor trigger`	Trigger an executor manually.
`executor webhook`	Manage executor webhooks

executor list

List all executors

Usage

tailor-sdk executor 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	-

executor get

Get executor details

Usage

tailor-sdk executor get [options] <name>

Arguments

Argument	Description	Required
`name`	Executor 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	-

executor jobs

List or get executor jobs.

Usage

tailor-sdk executor jobs [options] <executorName> [jobId]

Arguments

Argument	Description	Required
`executorName`	Executor name	Yes
`jobId`	Job ID (if provided, shows job 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	-
`--status <STATUS>`	`-s`	Filter by status (PENDING, RUNNING, SUCCESS, FAILED, CANCELED) (list mode only)	No	-
`--attempts`	-	Show job attempts (only with job ID) (detail mode only)	No	`false`
`--wait`	`-W`	Wait for job completion and downstream execution (workflow/function) if applicable (detail mode only)	No	`false`
`--interval <INTERVAL>`	`-i`	Polling interval when using --wait (e.g., '3s', '500ms', '1m')	No	`"3s"`
`--logs`	`-l`	Display function execution logs after completion (requires --wait)	No	`false`
`--limit <LIMIT>`	-	Maximum number of jobs to list (default: 50, max: 1000) (list mode only)	No	-

Examples

List jobs for an executor (default: 50 jobs)

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">jobs</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span></span>
<span></span>

Limit the number of jobs

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">jobs</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">--limit</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-constant)">10</span></span>
<span></span>

Filter by status

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">jobs</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</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>

Get job details

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">jobs</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)">&lt;</span><span style="color: var(--shiki-token-string)">job-i</span><span style="color: var(--shiki-color-text)">d</span><span style="color: var(--shiki-token-keyword)">&gt;</span></span>
<span></span>

Get job details with attempts

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">jobs</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)">&lt;</span><span style="color: var(--shiki-token-string)">job-i</span><span style="color: var(--shiki-color-text)">d</span><span style="color: var(--shiki-token-keyword)">&gt;</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">--attempts</span></span>
<span></span>

Wait for job to complete

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">jobs</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)">&lt;</span><span style="color: var(--shiki-token-string)">job-i</span><span style="color: var(--shiki-color-text)">d</span><span style="color: var(--shiki-token-keyword)">&gt;</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-W</span></span>
<span></span>

Wait for job with logs

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">jobs</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)">&lt;</span><span style="color: var(--shiki-token-string)">job-i</span><span style="color: var(--shiki-color-text)">d</span><span style="color: var(--shiki-token-keyword)">&gt;</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-W</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-l</span></span>
<span></span>

executor trigger

Trigger an executor manually.

Usage

tailor-sdk executor trigger [options] <executorName>

Arguments

Argument	Description	Required
`executorName`	Executor 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	-
`--data <DATA>`	`-d`	Request body (JSON string)	No	-
`--header <HEADER>`	`-H`	Request header (format: 'Key: Value', can be specified multiple times)	No	-
`--wait`	`-W`	Wait for job completion and downstream execution (workflow/function) if applicable	No	`false`
`--interval <INTERVAL>`	`-i`	Polling interval when using --wait (e.g., '3s', '500ms', '1m')	No	`"3s"`
`--logs`	`-l`	Display function execution logs after completion (requires --wait)	No	`false`

Examples

Trigger an executor

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">trigger</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span></span>
<span></span>

Trigger with data

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">trigger</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-d</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">&#39;{&quot;message&quot;: &quot;hello&quot;}&#39;</span></span>
<span></span>

Trigger with data and headers

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">trigger</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-d</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">&#39;{&quot;message&quot;: &quot;hello&quot;}&#39;</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-H</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">&quot;X-Custom: value&quot;</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-H</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">&quot;X-Another: value2&quot;</span></span>
<span></span>

Trigger and wait for completion

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">trigger</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-W</span></span>
<span></span>

Trigger, wait, and show logs

<span><span style="color: var(--shiki-token-function)">$</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">tailor-sdk</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">trigger</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">my-executor</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-W</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string)">-l</span></span>
<span></span>

Notes

Only executors with INCOMING_WEBHOOK or SCHEDULE trigger types can be triggered manually. Executors with EVENT trigger types (such as recordCreated, recordUpdated, recordDeleted) cannot be triggered manually.

The --data and --header options are only available for INCOMING_WEBHOOK trigger type.

Downstream Execution Tracking

When using --wait, the CLI tracks not only the executor job but also any downstream executions:

Workflow targets: Waits for the workflow execution to complete (SUCCESS, FAILED, or PENDING_RESUME). Shows real-time status changes and currently running job names during execution (same output as workflow start --wait).
Function targets: Waits for the function execution to complete
Webhook/GraphQL targets: Only waits for the executor job itself

The --logs option displays logs from the downstream execution when available.

executor webhook

Manage executor webhooks

Usage

tailor-sdk executor webhook [command]

Commands

Command	Description
`executor webhook list`	List executors with incoming webhook triggers

executor webhook list

List executors with incoming webhook triggers

Usage

tailor-sdk executor webhook 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	-