{
  "components": {
    "schemas": {
      "APIResponse": {
        "properties": {
          "data": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ],
            "title": "Data"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "success": {
            "title": "Success",
            "type": "boolean"
          }
        },
        "required": [
          "success",
          "message"
        ],
        "title": "APIResponse",
        "type": "object"
      },
      "BalanceSplit": {
        "description": "Getrennte Ausweisung des Prepaid-Guthabens (Transparenzgebot):\n\nWie viel des aktuellen Guthabens ist bezahlt (``paid``, bei Vertragsende\nerstattungsfähig) und wie viel geschenkt (``bonus``, Start-/Bonusguthaben,\nverfällt und wird nicht erstattet). Bonus wird rechnerisch zuerst\nverbraucht.",
        "properties": {
          "balance": {
            "default": 0.0,
            "title": "Balance",
            "type": "number"
          },
          "bonus": {
            "default": 0.0,
            "title": "Bonus",
            "type": "number"
          },
          "paid": {
            "default": 0.0,
            "title": "Paid",
            "type": "number"
          },
          "promo": {
            "items": {
              "$ref": "#/components/schemas/PromoLotInfo"
            },
            "title": "Promo",
            "type": "array"
          }
        },
        "title": "BalanceSplit",
        "type": "object"
      },
      "Body_upload_idml_api_v1_upload__post": {
        "properties": {
          "file": {
            "contentMediaType": "application/octet-stream",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_upload_idml_api_v1_upload__post",
        "type": "object"
      },
      "Body_upload_via_link_api_v1_public_uploads__token__post": {
        "properties": {
          "file": {
            "contentMediaType": "application/octet-stream",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_upload_via_link_api_v1_public_uploads__token__post",
        "type": "object"
      },
      "DownloadLink": {
        "properties": {
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "url": {
            "description": "Anyone holding this URL can download the file until it expires.",
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url",
          "expires_at"
        ],
        "title": "DownloadLink",
        "type": "object"
      },
      "FileAnalysis": {
        "properties": {
          "estimated_cost_per_language": {
            "description": "Estimated net price in EUR for one target language. A quote gives the binding price.",
            "title": "Estimated Cost Per Language",
            "type": "number"
          },
          "file_size": {
            "description": "Size in bytes.",
            "title": "File Size",
            "type": "integer"
          },
          "filename": {
            "description": "The `file_id` of the upload, used by all other endpoints.",
            "title": "Filename",
            "type": "string"
          },
          "stories_count": {
            "description": "Number of InDesign stories (text flows).",
            "title": "Stories Count",
            "type": "integer"
          },
          "total_characters": {
            "description": "Translatable characters in the document.",
            "title": "Total Characters",
            "type": "integer"
          },
          "translatable_segments": {
            "title": "Translatable Segments",
            "type": "integer"
          }
        },
        "required": [
          "filename",
          "file_size",
          "total_characters",
          "translatable_segments",
          "stories_count",
          "estimated_cost_per_language"
        ],
        "title": "FileAnalysis",
        "type": "object"
      },
      "GlossaryEntry": {
        "properties": {
          "comment": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment"
          },
          "id": {
            "title": "Id",
            "type": "integer"
          },
          "source_lang": {
            "title": "Source Lang",
            "type": "string"
          },
          "source_term": {
            "title": "Source Term",
            "type": "string"
          },
          "target_lang": {
            "title": "Target Lang",
            "type": "string"
          },
          "target_term": {
            "title": "Target Term",
            "type": "string"
          },
          "user_id": {
            "title": "User Id",
            "type": "integer"
          }
        },
        "required": [
          "source_term",
          "target_term",
          "source_lang",
          "target_lang",
          "id",
          "user_id"
        ],
        "title": "GlossaryEntry",
        "type": "object"
      },
      "GlossaryEntryCreate": {
        "properties": {
          "comment": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Comment"
          },
          "source_lang": {
            "title": "Source Lang",
            "type": "string"
          },
          "source_term": {
            "title": "Source Term",
            "type": "string"
          },
          "target_lang": {
            "title": "Target Lang",
            "type": "string"
          },
          "target_term": {
            "title": "Target Term",
            "type": "string"
          }
        },
        "required": [
          "source_term",
          "target_term",
          "source_lang",
          "target_lang"
        ],
        "title": "GlossaryEntryCreate",
        "type": "object"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "title": "Detail",
            "type": "array"
          }
        },
        "title": "HTTPValidationError",
        "type": "object"
      },
      "JobStatus": {
        "enum": [
          "pending",
          "processing",
          "completed",
          "failed",
          "cancelled"
        ],
        "title": "JobStatus",
        "type": "string"
      },
      "PromoLotInfo": {
        "properties": {
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "remaining": {
            "title": "Remaining",
            "type": "number"
          }
        },
        "required": [
          "remaining",
          "expires_at"
        ],
        "title": "PromoLotInfo",
        "type": "object"
      },
      "QuoteInfo": {
        "example": {
          "api_key_limit_remaining": 440.0,
          "available_funds": 150.0,
          "can_start": true,
          "cost_per_language": 30.0,
          "currency": "EUR",
          "expires_at": "2027-01-15T10:15:00Z",
          "file_id": "3f2b8c1e-5d47-4a9b-9c1e-7a2d4e6f8b10.idml",
          "filename": "catalogue-2027.idml",
          "price_per_word_net": 0.03,
          "quote_id": "0b9d6f0e-2f0a-4d0e-8f43-0d6f7f0d7c11",
          "source_language": "de",
          "target_languages": [
            "en-gb",
            "fr"
          ],
          "total_cost": 60.0,
          "total_words": 2000,
          "words_per_language": 1000
        },
        "properties": {
          "api_key_limit_remaining": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Remaining monthly limit of the API key in EUR. `null` means the key has no limit.",
            "title": "Api Key Limit Remaining"
          },
          "available_funds": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Balance or remaining monthly budget of the account in EUR. `null` means unlimited.",
            "title": "Available Funds"
          },
          "blocked_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Set when `can_start` is false: `insufficient_funds`, `api_key_limit_exceeded`, `quote_expired` or `already_started`.",
            "title": "Blocked Reason"
          },
          "can_start": {
            "description": "Whether the quote can be started right now.",
            "title": "Can Start",
            "type": "boolean"
          },
          "cost_per_language": {
            "description": "Net price in EUR for one target language.",
            "title": "Cost Per Language",
            "type": "number"
          },
          "currency": {
            "default": "EUR",
            "title": "Currency",
            "type": "string"
          },
          "expires_at": {
            "description": "The price is binding until this time (UTC).",
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "file_id": {
            "title": "File Id",
            "type": "string"
          },
          "filename": {
            "title": "Filename",
            "type": "string"
          },
          "job_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Set once a job has been started from this quote.",
            "title": "Job Id"
          },
          "price_per_word_net": {
            "description": "Net price per word in EUR for this account.",
            "title": "Price Per Word Net",
            "type": "number"
          },
          "quote_id": {
            "description": "Pass this to the start endpoint.",
            "title": "Quote Id",
            "type": "string"
          },
          "source_language": {
            "title": "Source Language",
            "type": "string"
          },
          "target_languages": {
            "items": {
              "type": "string"
            },
            "title": "Target Languages",
            "type": "array"
          },
          "test_mode": {
            "default": false,
            "description": "True for quotes created with a sandbox key (`mnl_test_...`). Starting one is free and returns unchanged copies of the file instead of a translation.",
            "title": "Test Mode",
            "type": "boolean"
          },
          "total_cost": {
            "description": "Maximum net price in EUR. The amount charged can be lower (translation memory hits, languages that could not be delivered), never higher.",
            "title": "Total Cost",
            "type": "number"
          },
          "total_words": {
            "description": "Billable words across all target languages.",
            "title": "Total Words",
            "type": "integer"
          },
          "words_per_language": {
            "description": "Billable words of the document for one language.",
            "title": "Words Per Language",
            "type": "integer"
          }
        },
        "required": [
          "quote_id",
          "file_id",
          "filename",
          "source_language",
          "target_languages",
          "words_per_language",
          "total_words",
          "price_per_word_net",
          "cost_per_language",
          "total_cost",
          "can_start",
          "expires_at"
        ],
        "title": "QuoteInfo",
        "type": "object"
      },
      "QuoteRequest": {
        "example": {
          "file_id": "3f2b8c1e-5d47-4a9b-9c1e-7a2d4e6f8b10.idml",
          "project_description": "Product catalogue 2027, formal tone",
          "source_language": "de",
          "target_languages": [
            "en-gb",
            "fr"
          ]
        },
        "properties": {
          "file_id": {
            "description": "ID of an uploaded file (`filename` of the upload response).",
            "title": "File Id",
            "type": "string"
          },
          "filename": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Display name of the job. Defaults to the original file name.",
            "title": "Filename"
          },
          "notify_email": {
            "default": false,
            "description": "E-mail the account owner when the job finishes or fails.",
            "title": "Notify Email",
            "type": "boolean"
          },
          "project_description": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Context for the translation: audience, tone, product. Improves quality.",
            "title": "Project Description"
          },
          "source_language": {
            "description": "Language code of the document, e.g. `de`.",
            "title": "Source Language",
            "type": "string"
          },
          "target_languages": {
            "description": "Language codes to translate into. One result file per language.",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "title": "Target Languages",
            "type": "array"
          },
          "use_tm": {
            "default": true,
            "description": "Use the account's translation memory. Repeated segments are reused and not charged.",
            "title": "Use Tm",
            "type": "boolean"
          }
        },
        "required": [
          "file_id",
          "source_language",
          "target_languages"
        ],
        "title": "QuoteRequest",
        "type": "object"
      },
      "TMEntryList": {
        "properties": {
          "entries": {
            "items": {
              "$ref": "#/components/schemas/TMEntryOut"
            },
            "title": "Entries",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "total",
          "entries"
        ],
        "title": "TMEntryList",
        "type": "object"
      },
      "TMEntryOut": {
        "properties": {
          "id": {
            "title": "Id",
            "type": "integer"
          },
          "origin": {
            "title": "Origin",
            "type": "string"
          },
          "source_lang": {
            "title": "Source Lang",
            "type": "string"
          },
          "source_text": {
            "title": "Source Text",
            "type": "string"
          },
          "target_lang": {
            "title": "Target Lang",
            "type": "string"
          },
          "target_text": {
            "title": "Target Text",
            "type": "string"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "required": [
          "id",
          "source_lang",
          "target_lang",
          "source_text",
          "target_text",
          "origin"
        ],
        "title": "TMEntryOut",
        "type": "object"
      },
      "TMPairStats": {
        "properties": {
          "entries": {
            "title": "Entries",
            "type": "integer"
          },
          "source_lang": {
            "title": "Source Lang",
            "type": "string"
          },
          "target_lang": {
            "title": "Target Lang",
            "type": "string"
          }
        },
        "required": [
          "source_lang",
          "target_lang",
          "entries"
        ],
        "title": "TMPairStats",
        "type": "object"
      },
      "TMStats": {
        "properties": {
          "enabled": {
            "title": "Enabled",
            "type": "boolean"
          },
          "pairs": {
            "items": {
              "$ref": "#/components/schemas/TMPairStats"
            },
            "title": "Pairs",
            "type": "array"
          },
          "total_entries": {
            "title": "Total Entries",
            "type": "integer"
          }
        },
        "required": [
          "enabled",
          "total_entries",
          "pairs"
        ],
        "title": "TMStats",
        "type": "object"
      },
      "TranslationJob": {
        "properties": {
          "characters_translated": {
            "default": 0,
            "title": "Characters Translated",
            "type": "integer"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed At"
          },
          "cost": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": 0.0,
            "description": "Net price in EUR. Final once the job is completed.",
            "title": "Cost"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "current_language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Language currently being translated.",
            "title": "Current Language"
          },
          "error_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Why the job failed, or a note when only some languages were delivered.",
            "title": "Error Message"
          },
          "file_id": {
            "title": "File Id",
            "type": "string"
          },
          "filename": {
            "title": "Filename",
            "type": "string"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "progress": {
            "default": 0.0,
            "description": "Progress from 0 to 100.",
            "title": "Progress",
            "type": "number"
          },
          "project_description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Description"
          },
          "result_files": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "Finished results: language code (or `_zip` for the archive) to file name. Use the keys as `language` with the download endpoints.",
            "title": "Result Files",
            "type": "object"
          },
          "results_available": {
            "default": false,
            "description": "Whether the result files can still be downloaded (kept for 24 hours).",
            "title": "Results Available",
            "type": "boolean"
          },
          "source_language": {
            "title": "Source Language",
            "type": "string"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "status": {
            "$ref": "#/components/schemas/JobStatus"
          },
          "target_languages": {
            "items": {
              "type": "string"
            },
            "title": "Target Languages",
            "type": "array"
          },
          "test_mode": {
            "default": false,
            "description": "Sandbox job: nothing was translated and nothing was charged.",
            "title": "Test Mode",
            "type": "boolean"
          },
          "total_characters": {
            "default": 0,
            "title": "Total Characters",
            "type": "integer"
          },
          "translation_log": {
            "description": "Notable events, such as segments that were left untranslated.",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Translation Log",
            "type": "array"
          },
          "use_tm": {
            "default": true,
            "title": "Use Tm",
            "type": "boolean"
          }
        },
        "required": [
          "job_id",
          "file_id",
          "filename",
          "source_language",
          "target_languages",
          "status",
          "created_at"
        ],
        "title": "TranslationJob",
        "type": "object"
      },
      "UploadLinkCreated": {
        "properties": {
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "max_size_mb": {
            "description": "Maximum file size in megabytes.",
            "title": "Max Size Mb",
            "type": "integer"
          },
          "upload_id": {
            "description": "Use this to check whether the file has arrived.",
            "title": "Upload Id",
            "type": "string"
          },
          "upload_page_url": {
            "description": "Web page with a drop zone for the same one-time link. Give this to a person who should upload the file in a browser.",
            "title": "Upload Page Url",
            "type": "string"
          },
          "upload_url": {
            "description": "Send the file here as `multipart/form-data`, field `file`, without an `Authorization` header. Works once.",
            "title": "Upload Url",
            "type": "string"
          }
        },
        "required": [
          "upload_id",
          "upload_url",
          "upload_page_url",
          "expires_at",
          "max_size_mb"
        ],
        "title": "UploadLinkCreated",
        "type": "object"
      },
      "UploadLinkStatus": {
        "properties": {
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "file": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FileAnalysis"
              },
              {
                "type": "null"
              }
            ],
            "description": "Analysis of the uploaded file, once it has arrived."
          },
          "status": {
            "description": "`pending`, `uploaded` or `expired`.",
            "title": "Status",
            "type": "string"
          },
          "upload_id": {
            "title": "Upload Id",
            "type": "string"
          }
        },
        "required": [
          "upload_id",
          "status",
          "expires_at"
        ],
        "title": "UploadLinkStatus",
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "ctx": {
            "title": "Context",
            "type": "object"
          },
          "input": {
            "title": "Input"
          },
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "title": "Location",
            "type": "array"
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        },
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError",
        "type": "object"
      }
    },
    "securitySchemes": {
      "HTTPBearer": {
        "description": "API key created in the manilo app, e.g. `mnl_live_...`.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Translate Adobe InDesign IDML files with manilo, from your own tools or an AI agent.\n\n**Workflow**\n\n1. Upload an IDML file, directly or through a one-time upload link.\n2. Request a quote. It fixes file, languages and price for a limited time and costs nothing.\n3. Start the translation from the quote. Starting is idempotent.\n4. Poll the job, then download the result or hand out a signed download link.\n\n**Authentication**\n\nSend your API key as a bearer token: `Authorization: Bearer mnl_live_...`.\nKeys are created in the manilo app, belong to one account and spend that\naccount's balance. Each key carries scopes and an optional monthly limit in EUR.\nThe two `/public/...` endpoints take no API key: the token or signature in the\nURL is the credential.\n\n**Errors**\n\nErrors are JSON objects with a `detail` field. `401` invalid, expired or revoked\nkey, `403` missing scope, `402` insufficient balance or key limit, `404` unknown\nor foreign resource, `410` expired quote, `429` rate limit (see `Retry-After`).\n\n**Prices**\n\nAll amounts are net prices in EUR. The amount charged for a job never exceeds\nthe quoted `total_cost`; it can be lower when segments are served from your\ntranslation memory.\n",
    "title": "manilo API",
    "version": "1.1.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/v1/billing/balance": {
      "get": {
        "description": "`balance` is what can be spent, in EUR. `paid` is purchased credit, `bonus` is free credit that is used first and can expire.\n\nRequired scope: `billing:read`.",
        "operationId": "getBalance",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BalanceSplit"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Get the account balance",
        "tags": [
          "Account"
        ],
        "x-order": 22,
        "x-required-scope": "billing:read"
      }
    },
    "/api/v1/glossary/": {
      "get": {
        "description": "Glossary entries force a fixed translation for a term in one language pair.\n\nRequired scope: `glossary:write`.",
        "operationId": "listGlossary",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/GlossaryEntry"
                  },
                  "title": "Response List Glossary Api V1 Glossary  Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "List glossary entries",
        "tags": [
          "Glossary and memory"
        ],
        "x-order": 17,
        "x-required-scope": "glossary:write"
      },
      "post": {
        "description": "The entry applies to all future translations of the account.\n\nRequired scope: `glossary:write`.",
        "operationId": "createGlossaryEntry",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GlossaryEntryCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GlossaryEntry"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Add a glossary entry",
        "tags": [
          "Glossary and memory"
        ],
        "x-order": 18,
        "x-required-scope": "glossary:write"
      }
    },
    "/api/v1/glossary/{entry_id}": {
      "delete": {
        "description": "Removes the entry. Finished translations are not changed.\n\nRequired scope: `glossary:write`.",
        "operationId": "deleteGlossaryEntry",
        "parameters": [
          {
            "in": "path",
            "name": "entry_id",
            "required": true,
            "schema": {
              "title": "Entry Id",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Delete a glossary entry",
        "tags": [
          "Glossary and memory"
        ],
        "x-order": 19,
        "x-required-scope": "glossary:write"
      }
    },
    "/api/v1/jobs/": {
      "get": {
        "description": "Required scope: `jobs:read`.",
        "operationId": "listJobs",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/TranslationJob"
                  },
                  "title": "Response List Jobs Api V1 Jobs  Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "List jobs",
        "tags": [
          "Jobs"
        ],
        "x-order": 10,
        "x-required-scope": "jobs:read"
      }
    },
    "/api/v1/jobs/{job_id}": {
      "delete": {
        "description": "Required scope: `translations:write`.",
        "operationId": "deleteJob",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Delete a job and its result files",
        "tags": [
          "Jobs"
        ],
        "x-order": 16,
        "x-required-scope": "translations:write"
      },
      "get": {
        "description": "`status` is `pending`, `processing`, `completed`, `failed` or `cancelled`; `progress` runs from 0 to 100.\n\nRequired scope: `jobs:read`.",
        "operationId": "getJob",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranslationJob"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Get a job",
        "tags": [
          "Jobs"
        ],
        "x-order": 11,
        "x-required-scope": "jobs:read"
      }
    },
    "/api/v1/jobs/{job_id}/cancel": {
      "post": {
        "description": "Required scope: `translations:write`.",
        "operationId": "cancelJob",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Cancel a running job",
        "tags": [
          "Jobs"
        ],
        "x-order": 15,
        "x-required-scope": "translations:write"
      }
    },
    "/api/v1/jobs/{job_id}/download": {
      "get": {
        "description": "`language=_zip` (default) returns all languages as one ZIP archive; a language code returns that single IDML file. Result files are kept for 24 hours.\n\nRequired scope: `jobs:read`.",
        "operationId": "downloadResult",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "language",
            "required": false,
            "schema": {
              "default": "_zip",
              "title": "Language",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Download a result file",
        "tags": [
          "Jobs"
        ],
        "x-order": 12,
        "x-required-scope": "jobs:read"
      }
    },
    "/api/v1/jobs/{job_id}/download-link": {
      "get": {
        "description": "Signed, time-limited URL for one result file (no auth header needed).\n\nMeant for handing a result to a person in a chat. Anyone holding the\nURL can download the file until it expires, so treat it like the file.\n\nRequired scope: `jobs:read`.",
        "operationId": "createDownloadLink",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "language",
            "required": false,
            "schema": {
              "default": "_zip",
              "title": "Language",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DownloadLink"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Create a signed download link",
        "tags": [
          "Jobs"
        ],
        "x-order": 13,
        "x-required-scope": "jobs:read"
      }
    },
    "/api/v1/public/downloads/{job_id}": {
      "get": {
        "description": "Download a result file with a link from ``/jobs/{id}/download-link``.",
        "operationId": "downloadViaSignedLink",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "expires",
            "required": true,
            "schema": {
              "title": "Expires",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "signature",
            "required": true,
            "schema": {
              "title": "Signature",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "language",
            "required": false,
            "schema": {
              "default": "_zip",
              "title": "Language",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Download through a signed link",
        "tags": [
          "Jobs"
        ],
        "x-order": 14
      }
    },
    "/api/v1/public/uploads/{token}": {
      "post": {
        "description": "Upload one IDML file through a one-time link (the token is the auth).",
        "operationId": "uploadViaLink",
        "parameters": [
          {
            "in": "path",
            "name": "token",
            "required": true,
            "schema": {
              "title": "Token",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_via_link_api_v1_public_uploads__token__post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadLinkStatus"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Upload a file through a one-time link",
        "tags": [
          "Files"
        ],
        "x-order": 6
      }
    },
    "/api/v1/quotes": {
      "post": {
        "description": "Binding price for translating one uploaded file. Costs nothing.\n\nRequired scope: `translations:write`.",
        "operationId": "createQuote",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QuoteRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteInfo"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Create a quote",
        "tags": [
          "Quotes"
        ],
        "x-order": 7,
        "x-required-scope": "translations:write"
      }
    },
    "/api/v1/quotes/{quote_id}": {
      "get": {
        "description": "Required scope: `translations:write`.",
        "operationId": "getQuote",
        "parameters": [
          {
            "in": "path",
            "name": "quote_id",
            "required": true,
            "schema": {
              "title": "Quote Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteInfo"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Get a quote",
        "tags": [
          "Quotes"
        ],
        "x-order": 8,
        "x-required-scope": "translations:write"
      }
    },
    "/api/v1/quotes/{quote_id}/start": {
      "post": {
        "description": "Start the translation exactly as quoted. Idempotent.\n\nCalling this again for the same quote returns the job that was already\nstarted instead of starting (and charging) a second one.\n\nRequired scope: `translations:write`.",
        "operationId": "startQuote",
        "parameters": [
          {
            "in": "path",
            "name": "quote_id",
            "required": true,
            "schema": {
              "title": "Quote Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranslationJob"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Start the translation from a quote",
        "tags": [
          "Quotes"
        ],
        "x-order": 9,
        "x-required-scope": "translations:write"
      }
    },
    "/api/v1/tm/entries": {
      "get": {
        "description": "Stored segment pairs, newest first. `q` searches source and target text.\n\nRequired scope: `tm:read`.",
        "operationId": "listTranslationMemoryEntries",
        "parameters": [
          {
            "in": "query",
            "name": "source_lang",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Source Lang"
            }
          },
          {
            "in": "query",
            "name": "target_lang",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Target Lang"
            }
          },
          {
            "in": "query",
            "name": "q",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 200,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Q"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 200,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TMEntryList"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Search the translation memory",
        "tags": [
          "Glossary and memory"
        ],
        "x-order": 21,
        "x-required-scope": "tm:read"
      }
    },
    "/api/v1/tm/stats": {
      "get": {
        "description": "Number of stored segments per language pair, and whether the memory is switched on.\n\nRequired scope: `tm:read`.",
        "operationId": "getTranslationMemoryStats",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TMStats"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Get translation memory statistics",
        "tags": [
          "Glossary and memory"
        ],
        "x-order": 20,
        "x-required-scope": "tm:read"
      }
    },
    "/api/v1/translate/languages": {
      "get": {
        "description": "Language codes accepted as `source_language` and `target_languages`.",
        "operationId": "listLanguages",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [],
        "summary": "List supported languages",
        "tags": [
          "Reference"
        ],
        "x-order": 23
      }
    },
    "/api/v1/upload-links": {
      "post": {
        "description": "One-time URL that accepts a single IDML file without an auth header.\n\nRequired scope: `files:write`.",
        "operationId": "createUploadLink",
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadLinkCreated"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Create a one-time upload link",
        "tags": [
          "Files"
        ],
        "x-order": 4,
        "x-required-scope": "files:write"
      }
    },
    "/api/v1/upload-links/{upload_id}": {
      "get": {
        "description": "`status` is `pending`, `uploaded` or `expired`. Once uploaded, `file` holds the analysis and `file.filename` is the `file_id`.\n\nRequired scope: `files:write`.",
        "operationId": "getUploadLink",
        "parameters": [
          {
            "in": "path",
            "name": "upload_id",
            "required": true,
            "schema": {
              "title": "Upload Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadLinkStatus"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Check whether a file arrived through an upload link",
        "tags": [
          "Files"
        ],
        "x-order": 5,
        "x-required-scope": "files:write"
      }
    },
    "/api/v1/upload/": {
      "post": {
        "description": "Send the file as `multipart/form-data` in the field `file`. The returned `filename` is the `file_id` used by all other endpoints.\n\nRequired scope: `files:write`.",
        "operationId": "uploadFile",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_idml_api_v1_upload__post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FileAnalysis"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Upload an IDML file",
        "tags": [
          "Files"
        ],
        "x-order": 1,
        "x-required-scope": "files:write"
      }
    },
    "/api/v1/upload/{file_id}": {
      "delete": {
        "description": "Required scope: `files:write`.",
        "operationId": "deleteFile",
        "parameters": [
          {
            "in": "path",
            "name": "file_id",
            "required": true,
            "schema": {
              "title": "File Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Delete an uploaded file",
        "tags": [
          "Files"
        ],
        "x-order": 3,
        "x-required-scope": "files:write"
      }
    },
    "/api/v1/upload/{file_id}/analysis": {
      "get": {
        "description": "Required scope: `files:write`.",
        "operationId": "getFileAnalysis",
        "parameters": [
          {
            "in": "path",
            "name": "file_id",
            "required": true,
            "schema": {
              "title": "File Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FileAnalysis"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "HTTPBearer": []
          }
        ],
        "summary": "Get the analysis of an uploaded file",
        "tags": [
          "Files"
        ],
        "x-order": 2,
        "x-required-scope": "files:write"
      }
    }
  },
  "servers": [
    {
      "url": "https://app.manilo.ai"
    }
  ],
  "tags": [
    {
      "description": "Upload IDML files and inspect them.",
      "name": "Files"
    },
    {
      "description": "Binding prices and starting translations.",
      "name": "Quotes"
    },
    {
      "description": "Track translations and fetch results.",
      "name": "Jobs"
    },
    {
      "description": "Terminology and the translation memory of the account.",
      "name": "Glossary and memory"
    },
    {
      "description": "Balance of the account.",
      "name": "Account"
    },
    {
      "description": "Static reference data.",
      "name": "Reference"
    }
  ]
}
