Skip to content

Get pipeline execution by ID

GET
/pipeline-executions/{executionId}
executionId
required
string

Pipeline execution found

object
executionId
required
string
pipelineId
required
string
pipelineName
required
string
pipelineHandlerType
required
string
pipelineInputsSchema
required
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
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
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
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
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
value
Any of:
object
type
required
string
Allowed values: dataset
datasetId
required

Reference to datasets 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
status
required
string
Allowed values: pending running succeeded failed cancelled
input
nullable
output
nullable
errorMessage
required
string
nullable
progressPct
required
number
nullable
progressMessage
required
string
nullable
startedAt
required
string format: date-time
nullable
completedAt
required
string format: date-time
nullable
createdAt
required
string format: date-time
createdBy
required
string
nullable

Forbidden - insufficient permissions to access this execution

Pipeline execution not found