FileObject

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/moonshot-ai/main/json-schema/moonshot-ai-file-object-schema.json",
  "title": "FileObject",
  "x-generated": "2026-10-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/moonshot-ai-files-api-openapi.yml#/components/schemas/FileObject",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique file identifier"
    },
    "object": {
      "type": "string",
      "description": "Object type"
    },
    "bytes": {
      "type": "integer",
      "description": "File size in bytes"
    },
    "created_at": {
      "type": "integer",
      "description": "Unix timestamp when the file was created"
    },
    "filename": {
      "type": "string",
      "description": "Original file name"
    },
    "purpose": {
      "type": "string",
      "description": "Purpose used when uploading the file. file-extract: extract file contents; image: upload images for vision understanding; video: upload videos for video understanding; batch: upload JSONL files for batch processing",
      "enum": [
        "file-extract",
        "image",
        "video",
        "batch"
      ]
    },
    "status": {
      "type": "string",
      "description": "Processing status of the file"
    },
    "status_details": {
      "type": "string",
      "description": "Additional status details when processing fails or returns warnings"
    }
  },
  "required": [
    "id",
    "object",
    "bytes",
    "created_at",
    "filename",
    "purpose",
    "status"
  ]
}