> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e6data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List backfills

> list backfills. GET /api/v1/workloads/{workload_id}/backfills. Uses the same payload, validation, revision checks and response as the unified HTTP API.

ReferenceApplies to: Unified engine deployments

## Related guidance

[Addresses and access](https://docs.e6data.com/transformation/http/access.md) · [Request identity](https://docs.e6data.com/transformation/http/request-identity.md) · [Errors and recovery](https://docs.e6data.com/transformation/http/errors.md) · [Pagination and results](https://docs.e6data.com/transformation/http/results.md)


## OpenAPI

````yaml openapi/transformation.json GET /api/v1/workloads/{workload_id}/backfills
openapi: 3.1.0
info:
  description: >-
    HTTP contracts for the Unified engine. Requests use the connected
    deployment's access model and configured owner. Response examples are
    illustrative; inspect your engine response in your client. SQL-managed
    secrets, credentials, streaming pipelines and maintenance run through
    session operations.
  title: Laminar Unified HTTP API
  version: v1
servers:
  - url: https://engine.example.com
    description: >-
      Example engine origin. Replace it with your deployment URL and any API
      mount prefix.
security: []
paths:
  /api/v1/workloads/{workload_id}/backfills:
    get:
      tags:
        - Workloads
      summary: list backfills
      description: >-
        list backfills. GET /api/v1/workloads/{workload_id}/backfills. Uses the
        same payload, validation, revision checks and response as the unified
        HTTP API.
      operationId: list_backfills
      parameters:
        - in: path
          name: workload_id
          required: true
          schema:
            format: uuid
            type: string
        - in: query
          name: continuation_token
          required: false
          schema:
            type: string
        - in: query
          name: limit
          required: false
          schema:
            description: >-
              Page size, bounded by the server. For query results this counts
              Arrow batches, default 1.
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  continuation_token:
                    type:
                      - string
                      - 'null'
                  items:
                    items:
                      $ref: >-
                        #/components/schemas/kernel_scheduler_src_backfills_model_rs_BackfillRecord
                    type: array
                type: object
          description: Successful response.
        default:
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  message: Check the request fields
              schema:
                $ref: '#/components/schemas/ApiError'
          description: A rejected or failed request. Inspect error.code before retrying.
components:
  schemas:
    kernel_scheduler_src_backfills_model_rs_BackfillRecord:
      properties:
        created_at:
          $ref: '#/components/schemas/shared_common_src_time_rs_WallClockTimestamp'
        deliveries:
          items:
            $ref: '#/components/schemas/app_notifications_src_lib_rs_Delivery'
          type: array
        id:
          format: uuid
          type: string
        last_error:
          anyOf:
            - type: string
            - type: 'null'
        request:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_backfills_model_rs_BackfillRequest
        snapshot:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_workloads_model_rs_WorkloadRecord
          description: >-
            Pin the definition, effective options, revision, and schedule at
            acceptance.
        status:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_backfills_model_rs_BackfillStatus
        updated_at:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_time_rs_WallClockTimestamp
            - type: 'null'
        version:
          minimum: 0
          type: integer
        windows:
          items:
            $ref: >-
              #/components/schemas/kernel_scheduler_src_backfills_model_rs_BackfillWindow
          type: array
        workload_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
      required:
        - deliveries
        - id
        - workload_id
        - request
        - status
        - last_error
        - version
        - created_at
        - updated_at
        - windows
        - snapshot
      type: object
    ApiError:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
    shared_common_src_time_rs_WallClockTimestamp:
      properties:
        unix_millis:
          type: integer
      required:
        - unix_millis
      type: object
    app_notifications_src_lib_rs_Delivery:
      properties:
        attempts:
          minimum: 0
          type: integer
        event:
          $ref: '#/components/schemas/app_notifications_src_lib_rs_WorkflowEvent'
        last_error:
          anyOf:
            - type: string
            - type: 'null'
        next_attempt_unix_millis:
          type: integer
        status:
          $ref: '#/components/schemas/app_notifications_src_lib_rs_DeliveryStatus'
        subscription:
          $ref: >-
            #/components/schemas/shared_common_src_workflow_rs_NotificationSubscription
      required:
        - event
        - subscription
        - attempts
        - status
        - next_attempt_unix_millis
        - last_error
      type: object
    kernel_scheduler_src_backfills_model_rs_BackfillRequest:
      properties:
        expected_revision:
          minimum: 0
          type: integer
        from_unix_millis:
          type: integer
        max_active_runs:
          minimum: 0
          type: integer
        parameters:
          $ref: '#/components/schemas/shared_common_src_parameters_rs_ParameterValues'
        reprocess:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_backfills_model_rs_Reprocess
        run_backwards:
          type: boolean
        submission_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_SubmissionId'
        to_unix_millis:
          type: integer
      required:
        - submission_id
        - from_unix_millis
        - to_unix_millis
        - expected_revision
        - parameters
        - reprocess
        - max_active_runs
        - run_backwards
      type: object
    kernel_scheduler_src_workloads_model_rs_WorkloadRecord:
      properties:
        created_at:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_time_rs_WallClockTimestamp
            - type: 'null'
        creation:
          anyOf:
            - $ref: >-
                #/components/schemas/kernel_scheduler_src_workloads_model_rs_WorkloadScheduleRequest
            - type: 'null'
        definition:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadDefinition'
        dispatching_occurrence_id:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_OccurrenceId'
            - type: 'null'
        kind:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadKind'
        last_workload_run_id:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
            - type: 'null'
        lateness_tolerance:
          properties:
            nanos:
              maximum: 999999999
              minimum: 0
              type: integer
            secs:
              minimum: 0
              type: integer
          required:
            - secs
            - nanos
          type: object
        latest_run_id:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
            - type: 'null'
        next_dispatch_sequence:
          minimum: 0
          type: integer
        next_evaluation_at:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_time_rs_WallClockTimestamp
            - type: 'null'
        next_occurrence_sequence:
          minimum: 0
          type: integer
        options:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_workloads_model_rs_ResolvedWorkloadSubmissionOptions
        pending_due_at:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_time_rs_WallClockTimestamp
            - type: 'null'
        pending_occurrence_id:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_OccurrenceId'
            - type: 'null'
        policy:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_scheduling_model_rs_SchedulingPolicy
        recording_context:
          anyOf:
            - $ref: '#/components/schemas/telemetry_src_models_rs_RecordingContext'
            - type: 'null'
        requested_options:
          $ref: >-
            #/components/schemas/shared_common_src_lib_rs_WorkloadSubmissionOptions
        revision:
          minimum: 0
          type: integer
        scheduling_status:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_workloads_model_rs_ScheduleStatus
        submission_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_SubmissionId'
        updated_at:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_time_rs_WallClockTimestamp
            - type: 'null'
        version:
          minimum: 0
          type: integer
        workload_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
      required:
        - revision
        - created_at
        - updated_at
        - creation
        - kind
        - workload_id
        - submission_id
        - definition
        - requested_options
        - options
        - policy
        - scheduling_status
        - version
        - lateness_tolerance
        - pending_occurrence_id
        - dispatching_occurrence_id
        - next_dispatch_sequence
        - last_workload_run_id
        - latest_run_id
        - pending_due_at
        - next_occurrence_sequence
        - next_evaluation_at
      type: object
    kernel_scheduler_src_backfills_model_rs_BackfillStatus:
      oneOf:
        - const: running
          type: string
        - const: paused
          type: string
        - const: cancelled
          type: string
        - const: succeeded
          type: string
        - const: failed
          type: string
    kernel_scheduler_src_backfills_model_rs_BackfillWindow:
      properties:
        occurrence_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_OccurrenceId'
        previous_occurrence_id:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_OccurrenceId'
            - type: 'null'
        reason:
          anyOf:
            - type: string
            - type: 'null'
        run_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
        status:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_backfills_model_rs_WindowStatus
        submission_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_SubmissionId'
        window:
          $ref: '#/components/schemas/shared_common_src_workflow_rs_DataWindow'
      required:
        - window
        - previous_occurrence_id
        - status
        - reason
        - occurrence_id
        - run_id
        - submission_id
      type: object
    shared_common_src_lib_rs_WorkloadId:
      format: uuid
      type: string
    app_notifications_src_lib_rs_WorkflowEvent:
      properties:
        backfill_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        id:
          type: string
        kind:
          $ref: '#/components/schemas/shared_common_src_workflow_rs_WorkflowEventKind'
        occurred_at_unix_millis:
          type: integer
        run_id:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
            - type: 'null'
        task:
          anyOf:
            - type: string
            - type: 'null'
        workload_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
      required:
        - id
        - workload_id
        - run_id
        - backfill_id
        - task
        - kind
        - occurred_at_unix_millis
      type: object
    app_notifications_src_lib_rs_DeliveryStatus:
      oneOf:
        - const: pending
          type: string
        - const: in_flight
          type: string
        - const: delivered
          type: string
        - const: exhausted
          type: string
    shared_common_src_workflow_rs_NotificationSubscription:
      properties:
        channel:
          $ref: >-
            #/components/schemas/shared_common_src_workflow_rs_NotificationChannel
        events:
          items:
            $ref: >-
              #/components/schemas/shared_common_src_workflow_rs_WorkflowEventKind
          type: array
        max_attempts:
          minimum: 0
          type: integer
        name:
          type: string
      required:
        - name
        - channel
        - events
        - max_attempts
      type: object
    shared_common_src_parameters_rs_ParameterValues:
      additionalProperties:
        description: JSON value; fields depend on the enclosing document or provider.
      type: object
    kernel_scheduler_src_backfills_model_rs_Reprocess:
      oneOf:
        - const: missing
          type: string
        - const: failed
          type: string
        - const: all
          type: string
    shared_common_src_lib_rs_SubmissionId:
      format: uuid
      type: string
    kernel_scheduler_src_workloads_model_rs_WorkloadScheduleRequest:
      properties:
        definition:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadDefinition'
        kind:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadKind'
        options:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_workloads_model_rs_ResolvedWorkloadSubmissionOptions
        policy:
          $ref: >-
            #/components/schemas/kernel_scheduler_src_scheduling_model_rs_SchedulingPolicy
        requested_options:
          $ref: >-
            #/components/schemas/shared_common_src_lib_rs_WorkloadSubmissionOptions
        submission_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_SubmissionId'
      required:
        - kind
        - submission_id
        - definition
        - requested_options
        - options
        - policy
      type: object
    shared_common_src_lib_rs_WorkloadDefinition:
      properties:
        dependencies:
          items:
            $ref: '#/components/schemas/shared_common_src_lib_rs_TaskDependency'
          type: array
        name:
          anyOf:
            - type: string
            - type: 'null'
        parameters:
          additionalProperties:
            $ref: >-
              #/components/schemas/shared_common_src_parameters_rs_ParameterDefinition
          type: object
        tasks:
          items:
            $ref: '#/components/schemas/shared_common_src_lib_rs_TaskDefinition'
          type: array
        workflow:
          $ref: '#/components/schemas/shared_common_src_workflow_rs_WorkflowOptions'
      required:
        - name
        - tasks
        - dependencies
      type: object
    shared_common_src_lib_rs_OccurrenceId:
      format: uuid
      type: string
    shared_common_src_lib_rs_WorkloadKind:
      oneOf:
        - const: Standalone
          type: string
        - const: Streaming
          type: string
        - const: SessionOperation
          type: string
    shared_common_src_lib_rs_WorkloadRunId:
      format: uuid
      type: string
    kernel_scheduler_src_workloads_model_rs_ResolvedWorkloadSubmissionOptions:
      properties:
        compute_requirements:
          $ref: '#/components/schemas/shared_common_src_lib_rs_ComputeRequirements'
        deployment_profile:
          anyOf:
            - type: string
            - type: 'null'
        execution_target:
          $ref: '#/components/schemas/shared_common_src_lib_rs_ExecutionTarget'
        execution_timeout:
          anyOf:
            - properties:
                nanos:
                  maximum: 999999999
                  minimum: 0
                  type: integer
                secs:
                  minimum: 0
                  type: integer
              required:
                - secs
                - nanos
              type: object
            - type: 'null'
        max_attempts:
          minimum: 1
          type: integer
        missed_run_policy:
          $ref: '#/components/schemas/shared_common_src_lib_rs_MissedRunPolicy'
        overlap_policy:
          $ref: '#/components/schemas/shared_common_src_lib_rs_OverlapPolicy'
        parallelism:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        profile:
          anyOf:
            - type: string
            - type: 'null'
        provisioner:
          anyOf:
            - type: string
            - type: 'null'
        queue_timeout:
          anyOf:
            - properties:
                nanos:
                  maximum: 999999999
                  minimum: 0
                  type: integer
                secs:
                  minimum: 0
                  type: integer
              required:
                - secs
                - nanos
              type: object
            - type: 'null'
        worker_scope:
          $ref: '#/components/schemas/shared_common_src_lib_rs_WorkerScope'
      required:
        - queue_timeout
        - worker_scope
        - parallelism
        - execution_target
        - execution_timeout
        - compute_requirements
        - max_attempts
        - missed_run_policy
        - overlap_policy
      type: object
    kernel_scheduler_src_scheduling_model_rs_SchedulingPolicy:
      oneOf:
        - const: Manual
          type: string
        - const: Immediately
          type: string
        - properties:
            At:
              properties:
                at:
                  $ref: >-
                    #/components/schemas/shared_common_src_time_rs_WallClockTimestamp
              required:
                - at
              type: object
          required:
            - At
          type: object
        - properties:
            Interval:
              properties:
                every:
                  properties:
                    nanos:
                      maximum: 999999999
                      minimum: 0
                      type: integer
                    secs:
                      minimum: 0
                      type: integer
                  required:
                    - secs
                    - nanos
                  type: object
                start_at:
                  $ref: >-
                    #/components/schemas/shared_common_src_time_rs_WallClockTimestamp
              required:
                - start_at
                - every
              type: object
          required:
            - Interval
          type: object
        - properties:
            Cron:
              properties:
                expression:
                  type: string
                timezone:
                  type: string
              required:
                - expression
                - timezone
              type: object
          required:
            - Cron
          type: object
    telemetry_src_models_rs_RecordingContext:
      properties:
        correlation:
          $ref: '#/components/schemas/telemetry_src_models_rs_LogCorrelation'
        execution:
          anyOf:
            - $ref: '#/components/schemas/telemetry_src_models_rs_ExecutionScope'
            - type: 'null'
        trace:
          anyOf:
            - $ref: '#/components/schemas/telemetry_src_models_rs_TraceContext'
            - type: 'null'
        worker_id:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_WorkerId'
            - type: 'null'
      required:
        - worker_id
        - trace
        - execution
        - correlation
      type: object
    shared_common_src_lib_rs_WorkloadSubmissionOptions:
      properties:
        compute_requirements:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_lib_rs_ComputeRequirements
            - type: 'null'
        deployment_profile:
          anyOf:
            - type: string
            - type: 'null'
        execution_target:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_ExecutionTarget'
            - type: 'null'
        execution_timeout:
          anyOf:
            - properties:
                nanos:
                  maximum: 999999999
                  minimum: 0
                  type: integer
                secs:
                  minimum: 0
                  type: integer
              required:
                - secs
                - nanos
              type: object
            - type: 'null'
        max_attempts:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        missed_run_policy:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_MissedRunPolicy'
            - type: 'null'
        overlap_policy:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_OverlapPolicy'
            - type: 'null'
        parallelism:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
          description: Maximum assigned tasks in one run. Unset has no run limit.
        profile:
          anyOf:
            - type: string
            - type: 'null'
        provisioner:
          anyOf:
            - type: string
            - type: 'null'
        queue_timeout:
          anyOf:
            - properties:
                nanos:
                  maximum: 999999999
                  minimum: 0
                  type: integer
                secs:
                  minimum: 0
                  type: integer
              required:
                - secs
                - nanos
              type: object
            - type: 'null'
        start_paused:
          type: boolean
        worker_scope:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_WorkerScope'
            - type: 'null'
        xray:
          type: boolean
      required:
        - queue_timeout
        - worker_scope
        - parallelism
        - execution_target
        - execution_timeout
        - compute_requirements
        - max_attempts
        - missed_run_policy
        - overlap_policy
      type: object
    kernel_scheduler_src_workloads_model_rs_ScheduleStatus:
      oneOf:
        - const: Active
          type: string
        - const: Paused
          type: string
        - const: Completed
          type: string
        - const: Cancelled
          type: string
        - const: Deleted
          type: string
    kernel_scheduler_src_backfills_model_rs_WindowStatus:
      oneOf:
        - const: pending
          type: string
        - const: submitted
          type: string
        - const: existing
          type: string
        - const: succeeded
          type: string
        - const: failed
          type: string
        - const: cancelled
          type: string
    shared_common_src_workflow_rs_DataWindow:
      properties:
        end_unix_millis:
          type: integer
        start_unix_millis:
          type: integer
        timezone:
          type: string
      required:
        - start_unix_millis
        - end_unix_millis
        - timezone
      type: object
    shared_common_src_workflow_rs_WorkflowEventKind:
      oneOf:
        - const: run_started
          type: string
        - const: run_succeeded
          type: string
        - const: run_failed
          type: string
        - const: run_cancelled
          type: string
        - const: outcome_unknown
          type: string
        - const: task_retry
          type: string
        - const: task_failed
          type: string
        - const: sensor_timeout
          type: string
        - const: backfill_completed
          type: string
        - const: backfill_failed
          type: string
    shared_common_src_workflow_rs_NotificationChannel:
      oneOf:
        - allOf:
            - properties:
                kind:
                  const: webhook
              required:
                - kind
              type: object
            - properties:
                secret:
                  anyOf:
                    - type: string
                    - type: 'null'
                url:
                  type: string
              required:
                - url
                - secret
              type: object
        - allOf:
            - properties:
                kind:
                  const: slack
              required:
                - kind
              type: object
            - properties:
                secret:
                  anyOf:
                    - type: string
                    - type: 'null'
                url:
                  type: string
              required:
                - url
                - secret
              type: object
    shared_common_src_lib_rs_TaskDependency:
      properties:
        downstream:
          type: string
        input_name:
          anyOf:
            - type: string
            - type: 'null'
        upstream:
          type: string
      required:
        - upstream
        - downstream
        - input_name
      type: object
    shared_common_src_parameters_rs_ParameterDefinition:
      properties:
        default:
          anyOf:
            - description: JSON value; fields depend on the enclosing document or provider.
            - type: 'null'
        description:
          anyOf:
            - type: string
            - type: 'null'
        enum:
          anyOf:
            - items:
                description: >-
                  JSON value; fields depend on the enclosing document or
                  provider.
              type: array
            - type: 'null'
        nullable:
          type: boolean
        required:
          type: boolean
        type:
          $ref: '#/components/schemas/shared_common_src_parameters_rs_ParameterType'
      required:
        - type
        - required
        - nullable
      type: object
    shared_common_src_lib_rs_TaskDefinition:
      allOf:
        - $ref: >-
            #/components/schemas/shared_common_src_execution_mod_rs_ExecutionOptions
        - properties:
            control:
              $ref: '#/components/schemas/shared_common_src_workflow_rs_TaskControl'
            incremental_source:
              anyOf:
                - $ref: >-
                    #/components/schemas/shared_common_src_lib_rs_IncrementalSource
                - type: 'null'
              description: Source cursor shared by this logical task across runs.
            local_relations:
              additionalProperties:
                description: >-
                  Serialized Relation; provider-specific fields retain their
                  original JSON representation.
                x-rust-type: Relation
              type: object
            name:
              type: string
            named_arguments:
              additionalProperties:
                description: >-
                  Serialized Expression; provider-specific fields retain their
                  original JSON representation.
                x-rust-type: Expression
              type: object
            positional_arguments:
              items:
                description: >-
                  Serialized Expression; provider-specific fields retain their
                  original JSON representation.
                x-rust-type: Expression
              type: array
            python:
              anyOf:
                - type: string
                - type: 'null'
            query:
              $ref: '#/components/schemas/shared_common_src_lib_rs_TaskQuery'
            settings:
              $ref: '#/components/schemas/shared_common_src_lib_rs_QuerySettings'
          required:
            - name
            - query
            - settings
            - named_arguments
            - positional_arguments
            - local_relations
          type: object
    shared_common_src_workflow_rs_WorkflowOptions:
      properties:
        data_windows:
          type: boolean
        notifications:
          items:
            $ref: >-
              #/components/schemas/shared_common_src_workflow_rs_NotificationSubscription
          type: array
      required:
        - data_windows
        - notifications
      type: object
    shared_common_src_lib_rs_ComputeRequirements:
      properties:
        cpu_millicores:
          minimum: 1
          type: integer
        memory_bytes:
          minimum: 1
          type: integer
        tuning:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_compute_rs_ComputeTuning'
            - type: 'null'
      required:
        - cpu_millicores
        - memory_bytes
      type: object
    shared_common_src_lib_rs_ExecutionTarget:
      oneOf:
        - const: DataFusion
          type: string
        - const: DuckDb
          type: string
    shared_common_src_lib_rs_MissedRunPolicy:
      oneOf:
        - const: RunOnce
          type: string
        - const: RunAll
          type: string
        - const: Skip
          type: string
    shared_common_src_lib_rs_OverlapPolicy:
      oneOf:
        - const: Wait
          type: string
        - const: Skip
          type: string
        - const: Allow
          type: string
    shared_common_src_lib_rs_WorkerScope:
      oneOf:
        - const: Task
          type: string
        - const: Workload
          type: string
        - const: Deployment
          type: string
    telemetry_src_models_rs_LogCorrelation:
      properties:
        allocation_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        assignment_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        catalog_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        cell_execution_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        commit_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        mutation_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        notebook_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        notebook_run_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        notebook_session_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        occurrence_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        operation_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        request_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        session_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        submission_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
      required:
        - request_id
        - mutation_id
        - assignment_id
        - occurrence_id
        - catalog_id
        - session_id
        - operation_id
        - submission_id
        - allocation_id
        - commit_id
        - notebook_id
        - notebook_session_id
        - notebook_run_id
        - cell_execution_id
      type: object
    telemetry_src_models_rs_ExecutionScope:
      oneOf:
        - allOf:
            - properties:
                level:
                  const: workload
              required:
                - level
              type: object
            - properties:
                workload_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
              required:
                - workload_id
              type: object
        - allOf:
            - properties:
                level:
                  const: run
              required:
                - level
              type: object
            - properties:
                workload_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
                workload_run_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
              required:
                - workload_id
                - workload_run_id
              type: object
        - allOf:
            - properties:
                level:
                  const: task
              required:
                - level
              type: object
            - properties:
                task_run_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_TaskRunId'
                workload_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
                workload_run_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
              required:
                - workload_id
                - workload_run_id
                - task_run_id
              type: object
        - allOf:
            - properties:
                level:
                  const: attempt
              required:
                - level
              type: object
            - properties:
                task_attempt_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_TaskAttemptId'
                task_run_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_TaskRunId'
                workload_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
                workload_run_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
              required:
                - workload_id
                - workload_run_id
                - task_run_id
                - task_attempt_id
              type: object
    telemetry_src_models_rs_TraceContext:
      properties:
        span_id:
          minimum: 0
          type: integer
        trace_flags:
          minimum: 0
          type: integer
        trace_id:
          format: uuid
          type: string
      required:
        - trace_id
        - span_id
        - trace_flags
      type: object
    shared_common_src_lib_rs_WorkerId:
      format: uuid
      type: string
    shared_common_src_parameters_rs_ParameterType:
      oneOf:
        - const: string
          type: string
        - const: string_array
          type: string
        - const: integer
          type: string
        - const: decimal
          type: string
        - const: boolean
          type: string
        - const: date
          type: string
        - const: timestamp
          type: string
    shared_common_src_execution_mod_rs_ExecutionOptions:
      properties:
        compute_requirements:
          anyOf:
            - $ref: >-
                #/components/schemas/shared_common_src_lib_rs_ComputeRequirements
            - type: 'null'
        deployment_profile:
          anyOf:
            - type: string
            - type: 'null'
        profile:
          anyOf:
            - type: string
            - type: 'null'
        provisioner:
          anyOf:
            - type: string
            - type: 'null'
        worker_scope:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_lib_rs_WorkerScope'
            - type: 'null'
        xray:
          type: boolean
      required: []
      type: object
    shared_common_src_workflow_rs_TaskControl:
      properties:
        retry:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_workflow_rs_RetryPolicy'
            - type: 'null'
        sensor:
          anyOf:
            - $ref: '#/components/schemas/shared_common_src_workflow_rs_SensorSpec'
            - type: 'null'
      required:
        - retry
        - sensor
      type: object
    shared_common_src_lib_rs_IncrementalSource:
      properties:
        branch:
          type: string
        table:
          $ref: '#/components/schemas/shared_common_src_lib_rs_TableReference'
      required:
        - table
        - branch
      type: object
    shared_common_src_lib_rs_TaskQuery:
      oneOf:
        - properties:
            Sql:
              type: string
          required:
            - Sql
          type: object
        - properties:
            Python:
              type: string
          required:
            - Python
          type: object
        - properties:
            Ast:
              description: >-
                Serialized Plan; provider-specific fields retain their original
                JSON representation.
              x-rust-type: Plan
          required:
            - Ast
          type: object
    shared_common_src_lib_rs_QuerySettings:
      properties:
        ansi_enabled:
          type: boolean
        case_sensitive:
          type: boolean
        current_catalog:
          type: string
        namespace:
          items:
            type: string
          type: array
        time_zone:
          type: string
      required:
        - current_catalog
        - namespace
        - time_zone
        - case_sensitive
        - ansi_enabled
      type: object
    shared_common_src_compute_rs_ComputeTuning:
      properties:
        batch_rows:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        file_read_concurrency:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        input_prefetch_batches:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
        native_parquet_scan:
          anyOf:
            - type: boolean
            - type: 'null'
          description: >-
            False always uses connector-produced Arrow batches. Omitted keeps
            the native Parquet capability enabled when the source can supply it
            safely.
        output_buffer_batches:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        query_memory_bytes:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        spill_bytes:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          description: >-
            Zero disables disk spill. The directory is controlled by the
            deployment.
        threads:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        write_batch_rows:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
        write_parallelism:
          anyOf:
            - minimum: 1
              type: integer
            - type: 'null'
      required:
        - threads
        - query_memory_bytes
        - batch_rows
        - write_batch_rows
        - write_parallelism
        - spill_bytes
        - output_buffer_batches
        - file_read_concurrency
        - input_prefetch_batches
      type: object
    shared_common_src_lib_rs_TaskRunId:
      format: uuid
      type: string
    shared_common_src_lib_rs_TaskAttemptId:
      format: uuid
      type: string
    shared_common_src_workflow_rs_RetryPolicy:
      properties:
        backoff:
          $ref: '#/components/schemas/shared_common_src_workflow_rs_Backoff'
        initial_delay_seconds:
          minimum: 0
          type: integer
        jitter_percent:
          description: >-
            Deterministic spread, derived from the saved task identity and
            attempt.
          minimum: 0
          type: integer
        max_attempts:
          minimum: 0
          type: integer
        max_delay_seconds:
          minimum: 0
          type: integer
        python_replay_safe:
          type: boolean
      required:
        - max_attempts
        - initial_delay_seconds
        - max_delay_seconds
        - backoff
        - jitter_percent
        - python_replay_safe
      type: object
    shared_common_src_workflow_rs_SensorSpec:
      properties:
        condition:
          $ref: '#/components/schemas/shared_common_src_workflow_rs_SensorCondition'
        poll_interval_seconds:
          minimum: 0
          type: integer
        timeout_seconds:
          minimum: 0
          type: integer
      required:
        - condition
        - timeout_seconds
        - poll_interval_seconds
      type: object
    shared_common_src_lib_rs_TableReference:
      properties:
        catalog_id:
          $ref: '#/components/schemas/shared_common_src_lib_rs_CatalogId'
        name:
          type: string
        namespace:
          items:
            type: string
          type: array
      required:
        - catalog_id
        - namespace
        - name
      type: object
    shared_common_src_workflow_rs_Backoff:
      oneOf:
        - const: fixed
          type: string
        - const: exponential
          type: string
    shared_common_src_workflow_rs_SensorCondition:
      oneOf:
        - allOf:
            - properties:
                kind:
                  const: object_exists
              required:
                - kind
              type: object
            - properties:
                url:
                  type: string
              required:
                - url
              type: object
        - allOf:
            - properties:
                kind:
                  const: http
              required:
                - kind
              type: object
            - properties:
                expected_status:
                  minimum: 0
                  type: integer
                expected_value:
                  anyOf:
                    - type: string
                    - type: 'null'
                json_pointer:
                  anyOf:
                    - type: string
                    - type: 'null'
                secret:
                  anyOf:
                    - type: string
                    - type: 'null'
                url:
                  type: string
              required:
                - url
                - expected_status
                - secret
                - json_pointer
                - expected_value
              type: object
        - allOf:
            - properties:
                kind:
                  const: workload_run
              required:
                - kind
              type: object
            - properties:
                run_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadRunId'
                workload_id:
                  $ref: '#/components/schemas/shared_common_src_lib_rs_WorkloadId'
              required:
                - workload_id
                - run_id
              type: object
    shared_common_src_lib_rs_CatalogId:
      format: uuid
      type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.