{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/telnyx/json-schema/telnyx-send-fax-multipart-request-schema.json",
  "title": "Send fax multipart request",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-programmable-fax-commands-api-openapi.yml#/components/schemas/SendFaxMultipartRequest",
  "properties": {
    "connection_id": {
      "$ref": "#/$defs/ConnectionId"
    },
    "contents": {
      "description": "The file you want to upload. The maximum allowed size is 20 MB. contents and media_name/media_url can't be submitted together.",
      "format": "binary",
      "type": "string"
    },
    "from": {
      "$ref": "#/$defs/From"
    },
    "monochrome": {
      "$ref": "#/$defs/Monochrome"
    },
    "quality": {
      "$ref": "#/$defs/Quality"
    },
    "store_media": {
      "$ref": "#/$defs/StoreMedia"
    },
    "store_preview": {
      "$ref": "#/$defs/StorePreview"
    },
    "t38_enabled": {
      "$ref": "#/$defs/T38Enabled"
    },
    "to": {
      "$ref": "#/$defs/To"
    }
  },
  "required": [
    "connection_id",
    "contents",
    "from",
    "to"
  ],
  "type": "object",
  "$defs": {
    "ConnectionId": {
      "description": "The ID of the connection used to send the fax.",
      "type": "string"
    },
    "From": {
      "description": "The phone number, in E.164 format, the fax will be sent from.",
      "type": "string"
    },
    "Monochrome": {
      "default": false,
      "description": "The flag to enable monochrome, true black and white fax results.",
      "type": "boolean"
    },
    "Quality": {
      "default": "high",
      "description": "The quality of the fax. The `ultra` settings provides the highest quality available, but also present longer fax processing times. `ultra_light` is best suited for images, wihle `ultra_dark` is best suited for text.",
      "enum": [
        "normal",
        "high",
        "very_high",
        "ultra_light",
        "ultra_dark"
      ],
      "type": "string"
    },
    "StoreMedia": {
      "default": false,
      "description": "Should fax media be stored on temporary URL. It does not support media_name, they can't be submitted together.",
      "type": "boolean"
    },
    "StorePreview": {
      "default": false,
      "description": "Should fax preview be stored on temporary URL.",
      "type": "boolean"
    },
    "T38Enabled": {
      "default": true,
      "description": "The flag to disable the T.38 protocol.",
      "type": "boolean"
    },
    "To": {
      "description": "The phone number, in E.164 format, the fax will be sent to or SIP URI",
      "type": "string"
    }
  }
}