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

# Retry a failed fine-tune

> Requeues a failed fine-tune with fresh credentials. If a confirmed training job can be recovered, retry resumes monitoring that job and submits only the remaining epochs. Otherwise, if no remote training model exists, retry restarts preparation. Returns 409 Conflict if the training service reported the failure (remote_training_failed), the fine-tune is not failed, a previous training workflow is still running, or remote training cannot be recovered because its identity or confirmed submission history is unavailable. When restarting preparation, the source dataset must be ready at the original revision, and any selected relabel must be completed for that revision; otherwise the request returns 409 Conflict. These dataset and relabel checks do not apply when resuming confirmed training.



## OpenAPI

````yaml openapi/model-distillation/management.openapi.yaml POST /projects/{alias}/finetunes/{finetuneId}/retry
openapi: 3.1.0
info:
  title: CoreWeave Model Distillation Management API
  version: 1.0.0
  description: |
    Manage providers, projects, routing versions, datasets, relabeling,
    fine-tunes, evaluations, and analytics. This is the same API used by
    Model Distillation.
servers:
  - url: https://forge.coreweave.com/api/distillation/v1
    description: Production
security:
  - WandbCredential: []
tags:
  - name: Providers
    description: OpenAI-compatible endpoints, credentials, model catalogs, and pricing.
  - name: Projects
    description: Stable project identity and project-level information.
  - name: Routing
    description: Versioned model targets, weights, and request parameters.
  - name: Datasets
    description: >-
      Reproducible data snapshots, entries, relabeling, and reusable model
      outputs.
  - name: Fine-tunes
    description: Supervised fine-tuning jobs and hosted model artifacts.
  - name: Evaluations
    description: Head-to-head, exact-match, and categorization evaluations.
  - name: Analytics
    description: Project traffic, token, error, and estimated-cost read models.
  - name: UI preferences
    description: Per-project display preferences used by the UI.
paths:
  /projects/{alias}/finetunes/{finetuneId}/retry:
    parameters:
      - $ref: '#/components/parameters/ForgeEntity'
      - $ref: '#/components/parameters/ProjectAlias'
      - $ref: '#/components/parameters/FinetuneId'
    post:
      tags:
        - Fine-tunes
      summary: Retry a failed fine-tune
      description: >-
        Requeues a failed fine-tune with fresh credentials. If a confirmed
        training job can be recovered, retry resumes monitoring that job and
        submits only the remaining epochs. Otherwise, if no remote training
        model exists, retry restarts preparation. Returns 409 Conflict if the
        training service reported the failure (remote_training_failed), the
        fine-tune is not failed, a previous training workflow is still running,
        or remote training cannot be recovered because its identity or confirmed
        submission history is unavailable. When restarting preparation, the
        source dataset must be ready at the original revision, and any selected
        relabel must be completed for that revision; otherwise the request
        returns 409 Conflict. These dataset and relabel checks do not apply when
        resuming confirmed training.
      operationId: retryFinetune
      responses:
        '200':
          description: The fine-tune was requeued.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Finetune'
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    ForgeEntity:
      name: Forge-Entity
      in: header
      required: false
      description: >-
        Accessible personal or team entity. Omit to list all accessible entities
        on `GET /projects` and `GET /projects/summaries`. Other endpoints use
        the authenticated user's default entity.
      schema:
        type: string
    ProjectAlias:
      name: alias
      in: path
      required: true
      schema:
        type: string
        pattern: ^[a-z0-9-]{1,64}$
    FinetuneId:
      name: finetuneId
      in: path
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    Finetune:
      type: object
      additionalProperties: true
      required:
        - id
        - task_id
        - dataset_id
        - model_name
        - base_model
        - default_temperature
        - status
        - training_progress
        - created_at
        - updated_at
      properties:
        training_failure_type:
          type:
            - string
            - 'null'
          description: >-
            Structured pipeline failure type. RemoteTrainingFailed means the
            training job cannot be resumed; create a new fine-tune instead of
            retrying.
        id:
          type: string
          format: uuid
        task_id:
          type: string
          format: uuid
        dataset_id:
          type: string
          format: uuid
        relabel_run_id:
          type:
            - string
            - 'null'
          format: uuid
        model_name:
          type: string
        base_model:
          type: string
        model_config:
          oneOf:
            - $ref: '#/components/schemas/FinetuneModelConfig'
            - type: 'null'
        default_temperature:
          type: number
          minimum: 0
          maximum: 2
          default: 0
        status:
          type: string
          enum:
            - queued
            - training
            - deployed
            - failed
        training_progress:
          type: number
          minimum: 0
          maximum: 100
        dataset_artifact_ref:
          type:
            - string
            - 'null'
        model_artifact_ref:
          type:
            - string
            - 'null'
        input_usd_per_mtok:
          type:
            - number
            - 'null'
        output_usd_per_mtok:
          type:
            - number
            - 'null'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    FinetuneModelConfig:
      type: object
      additionalProperties: false
      properties:
        max_examples:
          type: integer
          minimum: 1
        config:
          type: object
          additionalProperties: false
          properties:
            batch_size:
              oneOf:
                - type: string
                  const: auto
                - type: integer
                  minimum: 1
                  maximum: 32
            learning_rate:
              oneOf:
                - type: number
                  exclusiveMinimum: 0
                - type: array
                  minItems: 1
                  items:
                    type: number
                    minimum: 0
            assistant_turns:
              type: string
              enum:
                - all
                - last
            metric_logging:
              $ref: '#/components/schemas/JsonObject'
        experimental_config:
          $ref: '#/components/schemas/JsonObject'
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
            type:
              type: string
      example:
        error:
          message: Project 'missing' not found in entity 'your-team'
          type: not_found
    JsonObject:
      type: object
      additionalProperties: true
  responses:
    Error:
      description: Request failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    WandbCredential:
      type: http
      scheme: bearer
      bearerFormat: wandb API key or JWT
      description: >-
        A wandb API key or wandb JWT. Browser sessions are exchanged by the
        Model Distillation web app backend; job capabilities are internal only.

````