{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/telnyx/main/json-schema/telnyx-fine-tuning-job-schema.json",
  "title": "FineTuningJob",
  "description": "The `fine_tuning.job` object represents a fine-tuning job that has been created through the API.",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-fine-tuning-api-openapi.yml#/components/schemas/FineTuningJob",
  "properties": {
    "created_at": {
      "description": "The Unix timestamp (in seconds) for when the fine-tuning job was created.",
      "type": "integer"
    },
    "finished_at": {
      "description": "The Unix timestamp (in seconds) for when the fine-tuning job was finished. The value will be null if the fine-tuning job is still running.",
      "type": [
        "integer",
        "null"
      ]
    },
    "hyperparameters": {
      "description": "The hyperparameters used for the fine-tuning job.",
      "properties": {
        "n_epochs": {
          "default": 3,
          "description": "The number of epochs to train the model for. An epoch refers to one full cycle through the training dataset.",
          "maximum": 10,
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "n_epochs"
      ],
      "type": "object"
    },
    "id": {
      "description": "The name of the fine-tuned model that is being created.",
      "type": "string"
    },
    "model": {
      "description": "The base model that is being fine-tuned.",
      "type": "string"
    },
    "organization_id": {
      "description": "The organization that owns the fine-tuning job.",
      "type": "string"
    },
    "status": {
      "description": "The current status of the fine-tuning job.",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "cancelled"
      ],
      "type": "string"
    },
    "trained_tokens": {
      "description": "The total number of billable tokens processed by this fine-tuning job. The value will be null if the fine-tuning job is still running.",
      "type": [
        "integer",
        "null"
      ]
    },
    "training_file": {
      "description": "The storage bucket or object used for training.",
      "type": "string"
    }
  },
  "required": [
    "created_at",
    "finished_at",
    "hyperparameters",
    "id",
    "model",
    "organization_id",
    "status",
    "trained_tokens",
    "training_file"
  ],
  "type": "object"
}