file

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/sonetel/main/json-schema/sonetel-file-schema.json",
  "title": "file",
  "description": "File to be transcribed must be specified either via a `file_id`, a URL or by providing the file data",
  "x-generated": "2026-10-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sonetel-transcription-openapi.yml#/components/schemas/file",
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "file_id": {
          "type": "string",
          "description": "ID of the file to be transcribed."
        }
      }
    },
    {
      "type": "object",
      "properties": {
        "file_url": {
          "type": "string",
          "description": "URL of the file to be transcribed",
          "format": "uri"
        }
      }
    },
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "string",
          "description": "File data of the file to be transcribed",
          "format": "binary"
        }
      }
    }
  ]
}