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

# Multistart progress for a Data Fit element

> Multistart roll-up plus convergence traces, keyed by element.

This is the one resource a running Data Fit is polled through. The UI never
enumerates the child jobs itself: a 100-start fit used to cost a request per
child (and again on every window focus), which is what tripped the per-IP
edge rate limit for offices behind one address. Traces are keyed by
multistart index, so child job ids never reach the browser.



## OpenAPI

````yaml https://api.ionworks.com/openapi.json get /pipelines/elements/{element_id}/progress
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://api.ionworks.com
    description: Production
security: []
paths:
  /pipelines/elements/{element_id}/progress:
    get:
      tags:
        - Pipeline
      summary: Multistart progress for a Data Fit element
      description: >-
        Multistart roll-up plus convergence traces, keyed by element.


        This is the one resource a running Data Fit is polled through. The UI
        never

        enumerates the child jobs itself: a 100-start fit used to cost a request
        per

        child (and again on every window focus), which is what tripped the
        per-IP

        edge rate limit for offices behind one address. Traces are keyed by

        multistart index, so child job ids never reach the browser.
      operationId: >-
        get_pipeline_element_progress_pipelines_elements__element_id__progress_get
      parameters:
        - name: element_id
          in: path
          required: true
          schema:
            type: string
            title: Element Id
        - name: traces
          in: query
          required: false
          schema:
            enum:
              - best
              - all
            type: string
            description: >-
              Which convergence traces to include: the best multistart only
              (cheap enough to poll), or every multistart (one storage read per
              child; fetch once, on request).
            default: best
            title: Traces
          description: >-
            Which convergence traces to include: the best multistart only (cheap
            enough to poll), or every multistart (one storage read per child;
            fetch once, on request).
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElementProgressResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ElementProgressResponse:
      properties:
        element_id:
          type: string
          title: Element Id
        status:
          $ref: '#/components/schemas/PipelineElementStatus'
        progress:
          $ref: '#/components/schemas/ElementProgress'
        best_index:
          anyOf:
            - type: integer
            - type: 'null'
          title: Best Index
        traces:
          items:
            $ref: '#/components/schemas/MultistartTrace'
          type: array
          title: Traces
        traces_complete:
          type: boolean
          title: Traces Complete
          default: false
      type: object
      required:
        - element_id
        - status
        - progress
      title: ElementProgressResponse
      description: Response from GET /pipelines/elements/{element_id}/progress.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PipelineElementStatus:
      type: string
      enum:
        - pending
        - running
        - completed
        - failed
        - skipped
        - canceled
      title: PipelineElementStatus
    ElementProgress:
      properties:
        multistarts_total:
          type: integer
          title: Multistarts Total
        multistarts_by_status:
          additionalProperties:
            type: integer
          type: object
          title: Multistarts By Status
        best_cost:
          anyOf:
            - type: number
            - type: 'null'
          title: Best Cost
      type: object
      required:
        - multistarts_total
      title: ElementProgress
      description: >-
        Multistart roll-up for a Data Fit element, computed server-side so the
        UI

        never has to enumerate child jobs.
    MultistartTrace:
      properties:
        index:
          type: integer
          title: Index
        status:
          $ref: '#/components/schemas/JobStatus'
        cost:
          anyOf:
            - type: number
            - type: 'null'
          title: Cost
        history:
          items:
            additionalProperties: true
            type: object
          type: array
          title: History
      type: object
      required:
        - index
        - status
      title: MultistartTrace
      description: Convergence history of one multistart, for the progress chart.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    JobStatus:
      type: string
      enum:
        - pending
        - processing
        - waiting
        - completed
        - failed
        - canceled
      title: JobStatus
      description: Possible statuses for a job

````