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

# Get a fine-tuning job

> Available only to organizations enabled for fine-tuning; any other organization receives 400 invalid_request on every fine-tuning operation. Returns one job with its live progress: the current phase, step and split, when the phase began and when the job last reported anything, and the current step's rollout counts. Its metrics, rollouts and timeline are separate collections.



## OpenAPI

````yaml /recursion/openapi.yaml get /managed-agents/v2/fine-tuning-jobs/{jobId}
openapi: 3.1.0
info:
  title: Managed Agents API
  version: 0.17.0
  description: >-
    The Recursion Managed Agents REST API. Authenticate with a Recursion API key
    as a bearer token. An organization-scoped key acts in its own organization
    and needs nothing else; a tenant-scoped key must also send
    `x-organization-id` with an organization id or `default`. Field names follow
    each operation's published schema.
servers:
  - url: https://api.recursion.labelbox.com
security:
  - bearerAuth: []
paths:
  /managed-agents/v2/fine-tuning-jobs/{jobId}:
    get:
      tags:
        - Fine-tuning
      summary: Get a fine-tuning job
      description: >-
        Available only to organizations enabled for fine-tuning; any other
        organization receives 400 invalid_request on every fine-tuning
        operation. Returns one job with its live progress: the current phase,
        step and split, when the phase began and when the job last reported
        anything, and the current step's rollout counts. Its metrics, rollouts
        and timeline are separate collections.
      operationId: managedAgentsGetFineTuningJob
      parameters:
        - description: Fine-tuning job id.
          in: path
          name: jobId
          required: true
          schema:
            description: Fine-tuning job id.
            format: uuid
            type: string
        - $ref: '#/components/parameters/RecursionTenantId'
        - $ref: '#/components/parameters/RecursionOrganizationId'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FineTuningJob'
          description: OK
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorInvalidRequest'
                x-recursion-error-codes:
                  - invalid_request
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorUnauthorized'
                x-recursion-error-codes:
                  - unauthorized
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '403':
          description: Forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorForbidden'
                x-recursion-error-codes:
                  - forbidden
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '404':
          description: Not Found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorNotFound'
                x-recursion-error-codes:
                  - not_found
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '413':
          description: Payload Too Large.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorPayloadTooLarge'
                x-recursion-error-codes:
                  - payload_too_large
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '429':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
          description: Too Many Requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorRateLimitExceeded'
                x-recursion-error-codes:
                  - rate_limit_exceeded
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError'
                x-recursion-error-codes:
                  - internal_error
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '502':
          description: A dependent service returned an invalid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorDependencyFailure'
                x-recursion-error-codes:
                  - bad_gateway
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '503':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
          description: Service Unavailable.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
                discriminator:
                  propertyName: code
                  mapping:
                    managed_agents_unavailable: >-
                      #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                    service_unavailable: >-
                      #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
                x-recursion-error-codes:
                  - managed_agents_unavailable
                  - service_unavailable
        '504':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
          description: A dependent service timed out.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorDependencyTimeout'
                x-recursion-error-codes:
                  - gateway_timeout
components:
  parameters:
    RecursionTenantId:
      name: x-tenant-id
      in: header
      required: false
      description: >-
        Optional tenant consistency check. When present, it must name the tenant
        bound to the API key, including when x-organization-id is `default`.
      schema:
        minLength: 1
        type: string
    RecursionOrganizationId:
      name: x-organization-id
      in: header
      required: false
      description: >-
        Organization in which to act. Required for a tenant-scoped API key.
        Optional for an organization-scoped key, where it must name that same
        organization. The value may be an organization id or `default`.
      schema:
        minLength: 1
        type: string
  schemas:
    FineTuningJob:
      properties:
        completedAt:
          description: When the job reached a final status; null until then.
          format: date-time
          readOnly: true
          type:
            - 'null'
            - string
        createdAt:
          format: date-time
          readOnly: true
          type: string
        dataset:
          type: string
        datasetProvenance:
          $ref: '#/components/schemas/FineTuningDatasetProvenance'
          description: The dataset revision and split recorded when the job was created.
        failure:
          $ref: '#/components/schemas/FineTuningJobFailure'
          description: Why the job failed; null unless status is failed.
        jobId:
          format: uuid
          readOnly: true
          type: string
        model:
          type: string
        progress:
          $ref: '#/components/schemas/FineTuningJobProgress'
        result:
          $ref: '#/components/schemas/FineTuningJobResult'
          description: >-
            What the job produced. Both fields are null until the trainer saves
            a checkpoint; an evaluation-only job never has one.
        settings:
          $ref: '#/components/schemas/FineTuningJobSettings'
        startedAt:
          description: When a worker started the job; null while it is queued.
          format: date-time
          readOnly: true
          type:
            - 'null'
            - string
        status:
          description: >-
            queued until a worker starts it; succeeded, failed and cancelled are
            final.
          enum:
            - queued
            - running
            - succeeded
            - failed
            - cancelled
          readOnly: true
          type: string
        summary:
          $ref: '#/components/schemas/FineTuningJobSummaryScores'
          description: Scores derived from the job's metrics.
        updatedAt:
          format: date-time
          readOnly: true
          type: string
      required:
        - jobId
        - status
        - model
        - dataset
        - datasetProvenance
        - settings
        - progress
        - summary
        - result
        - failure
        - createdAt
        - updatedAt
        - startedAt
        - completedAt
      type: object
      additionalProperties: false
    ManagedAgentsApiErrorInvalidRequest:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - invalid_request
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorUnauthorized:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - unauthorized
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorForbidden:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - forbidden
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorNotFound:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - not_found
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorPayloadTooLarge:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - payload_too_large
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorRateLimitExceeded:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - rate_limit_exceeded
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorInternalError:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - internal_error
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorDependencyFailure:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - bad_gateway
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorManagedAgentsUnavailable:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - managed_agents_unavailable
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorServiceUnavailable:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - service_unavailable
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorDependencyTimeout:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - gateway_timeout
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    FineTuningDatasetProvenance:
      properties:
        heldOutTasks:
          description: Tasks in the held-out split.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        revision:
          description: The pinned AutomationBench commit the tasks come from.
          type: string
        splitSeed:
          description: >-
            Seed of the fixed shuffle that splits the tasks into train and
            held-out.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        trainTasks:
          description: Tasks in the train split.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
      readOnly: true
      required:
        - revision
        - splitSeed
        - trainTasks
        - heldOutTasks
      type: object
      additionalProperties: false
    FineTuningJobFailure:
      properties:
        exitCode:
          description: >-
            The worker's exit code; null when it never exited, for example when
            it could not start.
          type:
            - 'null'
            - integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        reason:
          description: Why the job failed.
          type: string
      readOnly: true
      required:
        - exitCode
        - reason
      type:
        - object
        - 'null'
      additionalProperties: false
    FineTuningJobProgress:
      properties:
        ingestErrors:
          description: >-
            Lines the worker reported that could not be read and were skipped;
            each is an ingest_error event in the timeline.
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        lastEventAt:
          description: >-
            When the job last reported anything, heartbeats included. A running
            job whose lastEventAt grows old is stalled.
          format: date-time
          type:
            - 'null'
            - string
        phase:
          description: >-
            What the job is doing now: queued from creation, cancelled once
            cancelled.
          enum:
            - queued
            - provisioning
            - installing
            - setup
            - sampling
            - training
            - eval
            - checkpoint
            - finalizing
            - done
            - failed
            - cancelled
          type: string
        phaseStartedAt:
          description: >-
            When the current phase began; null while the job is queued, whose
            wait starts at createdAt.
          format: date-time
          type:
            - 'null'
            - string
        rollouts:
          $ref: '#/components/schemas/FineTuningRolloutCounts'
          description: The current step's rollouts of the current split, by status.
        split:
          description: >-
            The split the current phase works on; null outside sampling and
            evaluation.
          enum:
            - train
            - eval
            - null
          type:
            - 'null'
            - string
        step:
          description: The step the job is on; null outside a step.
          type:
            - 'null'
            - integer
          minimum: -9007199254740991
          maximum: 9007199254740991
      readOnly: true
      required:
        - phase
        - step
        - split
        - phaseStartedAt
        - lastEventAt
        - rollouts
        - ingestErrors
      type: object
      additionalProperties: false
    FineTuningJobResult:
      properties:
        checkpointPath:
          description: >-
            The trainer's sampler checkpoint,
            tinker://<run>/sampler_weights/<name>.
          type:
            - 'null'
            - string
        tunedModel:
          description: The model id an agent selects to run the tuned model.
          type:
            - 'null'
            - string
      readOnly: true
      required:
        - checkpointPath
        - tunedModel
      type: object
      additionalProperties: false
    FineTuningJobSettings:
      description: The run settings the job trains with.
      properties:
        contextLength:
          description: Maximum tokens of one rollout's context.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        evalAttempts:
          description: >-
            Attempts per held-out task at each evaluation, for pass@k and
            pass^k.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        evalEvery:
          description: >-
            Steps between evaluations on held-out tasks. At most steps, or 1
            when steps is 0.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        evalSet:
          description: >-
            Held-out tasks each evaluation runs on: quick, a small fixed subset
            of the split's easiest tasks, or full, the whole split.
          enum:
            - quick
            - full
          type: string
        groupSize:
          description: Rollouts sampled per task; rewards are compared within a group.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        groupsPerBatch:
          description: Task groups per training step.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        learningRate:
          description: Optimizer learning rate.
          format: double
          type: number
        loraRank:
          description: Rank of the LoRA adapter that is trained.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        steps:
          description: >-
            Training steps the job runs. 0 is an evaluation-only baseline that
            trains nothing and saves no checkpoint.
          format: int64
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        trainSet:
          description: >-
            Train tasks the job trains on: quick, a small fixed subset of the
            split's easiest tasks, or full, the whole split. A full train set is
            cycled.
          enum:
            - quick
            - full
          type: string
      required:
        - learningRate
        - loraRank
        - groupSize
        - groupsPerBatch
        - steps
        - evalEvery
        - evalAttempts
        - trainSet
        - evalSet
        - contextLength
      type: object
      additionalProperties: false
    FineTuningJobSummaryScores:
      properties:
        evalReward:
          $ref: '#/components/schemas/FineTuningEvalReward'
      readOnly: true
      required:
        - evalReward
      type: object
      additionalProperties: false
    ManagedAgentsApiErrorDetails:
      type: object
      properties:
        field:
          description: >-
            Request field or header responsible for the error, when one can be
            identified.
          type: string
        issues:
          description: >-
            Boundary-validation failures as path-prefixed human-readable
            messages.
          type: array
          items:
            type: string
        requestId:
          description: Request correlation identifier for support and log lookup.
          type: string
        retryable:
          description: >-
            Server advice about failure transience. `true` means transient,
            `false` means non-transient, and absence gives no advice. Automatic
            replay is allowed only when this field is not `false` and the
            operation-specific retry and idempotency contract permits replay.
          type: boolean
      additionalProperties:
        $ref: '#/components/schemas/PlatformSafeJsonValue'
      description: >-
        Optional structured error details. Reserved transport fields are typed;
        code-specific fields remain forward compatible.
    FineTuningRolloutCounts:
      properties:
        done:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        failed:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        queued:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        running:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        total:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
      required:
        - queued
        - running
        - done
        - failed
        - total
      type: object
      additionalProperties: false
    FineTuningEvalReward:
      properties:
        base:
          description: >-
            Held-out reward at the first evaluation, before training; null until
            evaluated.
          type:
            - 'null'
            - number
        final:
          description: Held-out reward at the latest evaluation; null until evaluated.
          type:
            - 'null'
            - number
      required:
        - base
        - final
      type: object
      additionalProperties: false
    PlatformSafeJsonValue:
      description: >-
        A JSON value whose integer members stay within the exact ECMAScript
        safe-integer range at every nesting level.
      oneOf:
        - type: 'null'
        - type: boolean
        - type: string
        - type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        - type: number
          not:
            type: integer
        - type: array
          items:
            $ref: '#/components/schemas/PlatformSafeJsonValue'
        - additionalProperties:
            $ref: '#/components/schemas/PlatformSafeJsonValue'
          type: object
  headers:
    RecursionOrganizationId:
      description: Organization id resolved for this request.
      schema:
        minLength: 1
        type: string
    RecursionTenantId:
      description: Tenant id resolved for this request.
      schema:
        minLength: 1
        type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A Recursion API key, created in the console under API keys.

````