Skip to content

Cancel pipeline execution

POST
/pipeline-executions/{executionId}/cancel
executionId
required

Unique identifier of the execution to retrieve

string

Unique identifier of the execution to retrieve

Pipeline execution cancelled successfully

object
executionId
required

Unique identifier for this execution

string
pipelineId
required

ID of the pipeline being executed

string
pipelineName
required

Name of the pipeline at time of execution

string
pipelineHandlerType
required

Handler type used for execution (e.g., python, sql)

string
pipelineInputsSchema
required

Schema defining expected input parameters

object
files

File inputs/outputs

Array<object>
default:
object
id
required

Unique identifier for this file slot

string
label
required

Human-readable label for the file (e.g., ‘Input Document’)

string
description

Optional description of what this file represents

string
accept

Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)

string
required

Whether this file is required

boolean
default: true
multiple

Whether multiple files can be selected for this slot

boolean
contextRetrievalMode

How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks

string
default: full
Allowed values: semantic full
datasets

Dataset inputs/outputs

Array<object>
default:
object
id
required

Unique identifier for this dataset slot

string
label
required

Human-readable label for the dataset (e.g., ‘Training Data’)

string
description

Optional description of what this dataset represents

string
schema

JSON Schema describing the expected dataset structure

required

Whether this dataset is required

boolean
default: true
multiple

Whether multiple datasets can be selected for this slot

boolean
filter

Optional row-level filter applied to any dataset in this slot

Array<object>
object
field
required

Column name in the dataset table

string
op
required
string
Allowed values: eq neq gt gte lt lte in not_in like is_null is_not_null
value
Any of:
string
dataInputs

Structured data inputs/outputs

Array<object>
default:
object
id
required

Unique identifier for this data input slot

string
label
required

Human-readable label for the data input (e.g., ‘Parameters’)

string
description

Optional description of what this data input represents

string
schema
required

JSON Schema describing the expected data structure

required

Whether this data input is required

boolean
default: true
pipelineOutputsSchema
required

Schema defining expected output structure

object
files

File inputs/outputs

Array<object>
default:
object
id
required

Unique identifier for this file slot

string
label
required

Human-readable label for the file (e.g., ‘Input Document’)

string
description

Optional description of what this file represents

string
accept

Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)

string
required

Whether this file is required

boolean
default: true
multiple

Whether multiple files can be selected for this slot

boolean
contextRetrievalMode

How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks

string
default: full
Allowed values: semantic full
datasets

Dataset inputs/outputs

Array<object>
default:
object
id
required

Unique identifier for this dataset slot

string
label
required

Human-readable label for the dataset (e.g., ‘Training Data’)

string
description

Optional description of what this dataset represents

string
schema

JSON Schema describing the expected dataset structure

required

Whether this dataset is required

boolean
default: true
multiple

Whether multiple datasets can be selected for this slot

boolean
filter

Optional row-level filter applied to any dataset in this slot

Array<object>
object
field
required

Column name in the dataset table

string
op
required
string
Allowed values: eq neq gt gte lt lte in not_in like is_null is_not_null
value
Any of:
string
dataInputs

Structured data inputs/outputs

Array<object>
default:
object
id
required

Unique identifier for this data input slot

string
label
required

Human-readable label for the data input (e.g., ‘Parameters’)

string
description

Optional description of what this data input represents

string
schema
required

JSON Schema describing the expected data structure

required

Whether this data input is required

boolean
default: true
pipelineConfiguration
required

Pipeline configuration at time of execution

object
files

File configurations

Array<object>
default:
object
id
required

Unique identifier for this file slot

string
label
required

Human-readable label for the file (e.g., ‘Input Document’)

string
description

Optional description of what this file represents

string
accept

Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)

string
required

Whether this file is required

boolean
default: true
multiple

Whether multiple files can be selected for this slot

boolean
contextRetrievalMode

How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks

string
default: full
Allowed values: semantic full
value
Any of:
object
type
required
string
Allowed values: file
fileId
required

Reference to files table

string
datasets

Dataset configurations

Array<object>
default:
object
id
required

Unique identifier for this dataset slot

string
label
required

Human-readable label for the dataset (e.g., ‘Training Data’)

string
description

Optional description of what this dataset represents

string
schema

JSON Schema describing the expected dataset structure

required

Whether this dataset is required

boolean
default: true
multiple

Whether multiple datasets can be selected for this slot

boolean
filter

Optional row-level filter applied to any dataset in this slot

Array<object>
object
field
required

Column name in the dataset table

string
op
required
string
Allowed values: eq neq gt gte lt lte in not_in like is_null is_not_null
value
Any of:
string
value
Any of:
object
type
required
string
Allowed values: table
tableId
required

Reference to dataset_tables table

string
dataInputs

Structured data configurations

Array<object>
default:
object
id
required

Unique identifier for this data input slot

string
label
required

Human-readable label for the data input (e.g., ‘Parameters’)

string
description

Optional description of what this data input represents

string
schema
required

JSON Schema describing the expected data structure

required

Whether this data input is required

boolean
default: true
value
object
type
required
string
Allowed values: dataInput
value

Structured data value matching the schema

nullable
handlerOptions

LLM handler configuration

object
model

LLM model in {provider}/{model} format (e.g., vertexai/gemini-3-flash-preview)

string
temperature

Generation temperature (0 = deterministic, 2 = creative)

number
<= 2
maxTokens

Maximum output tokens

integer
webSearch

Web search configuration for automatic context retrieval

object
enabled
required

Enable automatic web search query generation and execution

boolean
maxQueries

Maximum number of queries to generate (1-5, default: 3)

integer
default: 3 >= 1 <= 5
maxResultsPerQuery

Maximum results per query (1-20, default: 5)

integer
default: 5 >= 1 <= 20
searchDepth

Search depth: basic (1 credit) or advanced (2 credits, default: basic)

string
default: basic
Allowed values: basic advanced
includeAnswer

Include AI-generated answer summary from Tavily (default: false)

boolean
urlScraping

URL scraping configuration

object
enabled

Enable automatic URL detection and scraping (default: true)

boolean
default: true
contentType

Content type for scraped pages (default: ‘markdown’)

string
default: markdown
Allowed values: html markdown text
renderJs

Enable JavaScript rendering (default: true)

boolean
default: true
iterationBudget

Maximum planning/retrieval iterations. Each iteration plans what to retrieve, fetches context, and evaluates sufficiency before answering.

integer
default: 1 >= 1 <= 20
status
required

Current execution status (pending, running, succeeded, failed, cancelled)

string
Allowed values: pending running succeeded failed cancelled
input

Input parameters provided for this execution

nullable
output

Output data from the execution, or null if not yet complete

nullable
outputCitations
required

Citations mapping output fields to source documents

Array<object>
object
outputPointer
required

JSON Pointer (RFC 6901) to field in output, e.g., ‘/keyMetrics/revenue’

string
outputCharStart

Starting character position of citation marker in output

integer
outputCharEnd

Ending character position of citation marker in output

integer
citations
required

Citations supporting this output field

Array
One of:
object
type
required
string
Allowed values: file
fileId
required

A unique nanoid for the resource (for more information please see: https://zelark.github.io/nano-id-cc/)

string
handlerOutput
required
One of:
object
handlerType
required
string
Allowed values: language_model
trace
object
traceId
required
string
rootSpanId
required
string
spans
required
Array<object>
object
spanId
required
string
parentSpanId
required
string
nullable
name
required
string
status
required
string
Allowed values: ok error
startTime
required
string
endTime
required
string
nullable
durationMs
required
number
nullable
attributes
required
One of:
object
kind
required
string
Allowed values: handler
iterationBudget
required
integer
iterationsUsed
required
integer
datasetCount
required
integer
fileCount
required
integer
error
object
message
required
string
code
string
errorMessage
required

Error message if execution failed

string
nullable
progressPct
required

Execution progress percentage (0-100), or null if not trackable

number
nullable
progressMessage
required

Human-readable progress message

string
nullable
startedAt
required

When execution actually started running

string format: date-time
nullable
completedAt
required

When execution completed (success or failure)

string format: date-time
nullable
createdAt
required

When the execution was queued

string format: date-time
createdBy
required

User ID who triggered this execution

string
nullable

Bad Request - Validation error or invalid input

object
error
required
string
code
string
details
nullable
retryable
boolean

Unauthorized - Authentication required or invalid token

object
error
required
string
code
string
details
nullable
retryable
boolean

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable
retryable
boolean

Not Found - Resource does not exist

object
error
required
string
code
string
details
nullable
retryable
boolean

Conflict - Resource already exists or operation conflicts with current state

object
error
required
string
code
string
details
nullable
retryable
boolean