Code Bundle Execution

List code bundle executions

GET/api/v2/code-bundle-executions
List code bundle executions in the account, optionally filtered by bundle, entrypoint, time range, type, status, execution name, or query id. All query parameters are optional; with none supplied, recent executions are returned (up to the result limit).

Query Parameters

ParameterDescription
bundleName string
Filter by code bundle name. To match a case-sensitive or special-character identifier, wrap the value in double quotes (for example "0303_replace_test"). Combine with database and schema to scope to a fully qualified bundle.
database string
Filter by the database supplied when the code bundle was created or executed.
schema string
Filter by the schema supplied when the code bundle was created or executed.
entrypoint string
Exact match on the executed entrypoint file path.
startTimeRangeStart string
Inclusive lower bound on the execution start time, interpreted as TIMESTAMP_LTZ. Accepts any timestamp literal (for example 2026-07-07 or 2026-07-07T00:00:00).
startTimeRangeEnd string
Inclusive upper bound on the execution start time, interpreted as TIMESTAMP_LTZ.
bundleTypes string
Comma-separated, case-insensitive list of bundle types to include. Allowed values: custom, ml, spark.
computeTypes string
Comma-separated, case-insensitive list of compute types to include. Allowed values: warehouse, compute_pool, serverless.
languageTypes string
Comma-separated, case-insensitive list of language types to include. Allowed values: python, java, scala.
status string
Filter by a single execution status (case-insensitive). Allowed values: pending, running, done (succeeded), failed, cancelled (canceled), deleted.
executionName string
Exact match on the caller-supplied execution name.
queryId string
Query id of the execute-code-bundle statement, to scope history to a single execution.
resultLimit integer
Maximum number of rows to return. Clamped to [1, CODE_BUNDLE_HISTORY_MAX_RESULT_LIMIT] (default 100).

Response

CodeDescription
200
successful
202
Successfully accepted the request, but it is not completed yet.

Execute a code bundle

POST/api/v2/code-bundle-executions
Execute a code bundle directly from a stage location, without first creating a named code bundle.

Query Parameters

ParameterDescription
asyncExec boolean
Asynchronous execution enable/disable. Default is disable.

Response

CodeDescription
200
Successful request.
202

Get the status of a code bundle execution

GET/api/v2/code-bundle-executions/{executionId}
Fetch the execution status and details of a code bundle execution identified by its execution id.

Response

CodeDescription
200
successful
202

Cancel a code bundle execution

POST/api/v2/code-bundle-executions/{executionId}:cancel
Cancel a running code bundle execution identified by its execution id.

Response

CodeDescription
200
202