ConversionDTO

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/file-convert-online/json-schema/file-convert-online-conversion-dto-schema.json",
  "title": "ConversionDTO",
  "description": "Full conversion record.",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/file-convert-online-mcp-openapi.json#/components/schemas/ConversionDTO",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer"
    },
    "uid": {
      "type": "string",
      "description": "Conversion UID."
    },
    "job_uid": {
      "type": "string",
      "description": "Underlying job UID (for job-level status if needed)."
    },
    "source_file_uid": {
      "type": "string",
      "description": "UID of the uploaded source file."
    },
    "converted_file_uid": {
      "type": "string",
      "description": "UID of the converted output file. Populated once status is `completed`. Pass this to GET /api/file/v1/file/download/{uid} to retrieve the result.\n"
    },
    "status": {
      "type": "string",
      "description": "Current status name. Canonical values (fetch the list from GET /api/conversion/v1/status rather than hardcoding): Received, Waiting, Processing, Completed, Failed.\n"
    },
    "conversion_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Format-type category name (e.g. \"image\", \"document\"). Null until the conversion record is fully committed. Wire field name is `conversion_type` — there is no `format_type_id` field on this DTO.\n"
    },
    "source_format_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Source format identifier as a string value. May be null until conversion is fully committed."
    },
    "target_format_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Target format identifier as a string value. May be null until conversion is fully committed."
    },
    "job_template_id": {
      "type": "integer"
    },
    "user_id": {
      "type": "integer"
    },
    "additional_arguments": {
      "type": "object",
      "additionalProperties": true
    },
    "effects": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ConversionEffectDTO"
      }
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "completed_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "$defs": {
    "ConversionEffectDTO": {
      "type": "object",
      "properties": {
        "effect": {
          "$ref": "#/$defs/EffectDTO"
        },
        "parameters": {
          "type": "object",
          "additionalProperties": true
        }
      }
    },
    "EffectDTO": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "display_name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        }
      }
    }
  }
}