Create a Document from a file in any of the formats documented in our knowledge base.
Request parameters should be passed as JSON object with the header field LILT-API.
File names in the header can only contain US-ASCII characters. File names with characters outside of US-ASCII should be URI encoded or transliterated to US-ASCII strings.
An optional parameter to auto-accept segments with 100% translation
memory matches when the pretranslate option is also set, or to
auto-accept any target data that is present when the uploaded file
is XLIFF. If omitted it will default to your organization settings for Accept and lock exact matches,
if set to false, no segments will be auto-accepted.
An optional parameter to use case sensitive translation memory matching when the pretranslate
option is also enabled. Matches must have identical character-by-character case to qualify as matches.
Default value matches your organization settings for Use case sensitive translation memory matching setting
An optional parameter to attribute translation authorship of exact matches to the author of the file
when the pretranslate option is also enabled. Default value matches your organization settings for Translation authorship setting
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LILT","colors":{"primary":"#0B1C56","light":"#28AE97","dark":"#28AE97"},"logo":{"light":"https://mintcdn.com/lilt-db26f913/UHeYNg6Mxux_MnCF/logo-dark.png?fit=max\u0026auto=format\u0026n=UHeYNg6Mxux_MnCF\u0026q=85\u0026s=ccd8915cfa0f94ab3acc0cd47519228b","dark":"https://mintcdn.com/lilt-db26f913/UHeYNg6Mxux_MnCF/logo-light.png?fit=max\u0026auto=format\u0026n=UHeYNg6Mxux_MnCF\u0026q=85\u0026s=6f87adfc249940e51b8f92f1b9b971dd"},"favicon":"https://mintcdn.com/lilt-db26f913/KxQB3_Ey1ahDkiRO/favicon.png?fit=max\u0026auto=format\u0026n=KxQB3_Ey1ahDkiRO\u0026q=85\u0026s=035f22384895e64a7088c628d48c4be2","background":{"color":{"dark":"#081A28"}},"navbar":{"links":[{"href":"https://lilt.atlassian.net/servicedesk/customer/portals","label":"Help Desk"}],"primary":{"type":"button","label":"Book a Demo","href":"https://lilt.com/contact"}},"footer":{"socials":{"github":"https://github.com/lilt","linkedin":"https://www.linkedin.com/company/lilthq","x":"https://x.com/LiltHQ","youtube":"https://www.youtube.com/@lilthq"}},"fonts":{"heading":{"family":"Basis Grotesque Pro","source":"https://mintlify-assets.b-cdn.net/BasisGrotesquePro.woff2","format":"woff2"},"body":{"family":"Basis Grotesque Pro","source":"https://mintlify-assets.b-cdn.net/BasisGrotesquePro.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"AI Research","icon":"books","href":"https://lilt.com/ai-research"},{"anchor":"Blog","icon":"book-open-cover","href":"https://lilt.com/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lilt-db26f913","hasAudioNarration":false,"actualSubdomain":"lilt-db26f913","customDomains":["support.lilt.com"],"gitSource":{"type":"github","owner":"lilt","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb2b6c385381993c300f0a","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":153},{"language":"default","tag":"Documentation","count":146},{"language":"default","tag":"Self-Managed","count":119},{"language":"default","tag":"System Administration","count":55},{"language":"default","tag":"Connect","count":49},{"language":"default","tag":"System Use","count":49},{"language":"default","tag":"Connectors","count":46},{"language":"default","tag":"Manage","count":31},{"language":"default","tag":"Verify","count":27},{"language":"default","tag":"System Configuration","count":27}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"globals.css","content":"@custom-variant dark (\u0026:is(.dark *));@theme{--color-primary: #2abfa3;--color-tertiary: #ad83fc;--color-dark: #081a28;--color-smoke: #a8acb5;--color-dark-smoke: #73767c;--color-transparent: rgba(0, 0, 0, 0);--text-xs: 12px;--text-sm: 14px;--text-base: 16px;--text-lg: 19.2px;--text-xl: 23px;--text-2xl: 27.6px;--text-3xl: 33.2px;--text-4xl: 39.8px;--text-5xl: 47.8px;--text-6xl: 57.3px;--font-sans:\n \"Basis Grotesque Pro\", -apple-system, BlinkMacSystemFont, \"Segoe UI\",\n Roboto, \"Helvetica Neue\", Arial, sans-serif;--screen-sm: 640px;--screen-md: 768px;--screen-lg: 1024px;--screen-xl: 1280px;--screen-2xl: 1536px}html,body{background:var(--background);color:var(--foreground);font-family:var(--font-sans);font-size:1rem;line-height:1.5}::-webkit-scrollbar{width:8px}::-webkit-scrollbar-track{background:rgba(8, 26, 40, 0.5)}::-webkit-scrollbar-thumb{background:rgba(168, 172, 181, 0.3);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:rgba(168, 172, 181, 0.5)}.default-px{padding-left:20px;padding-right:20px}.default-py{padding-top:56px;padding-bottom:56px}@media (min-width: 768px){.default-px{padding-left:40px;padding-right:40px}.default-py{padding-top:88px;padding-bottom:88px}}@media (min-width: 1024px){.default-px{padding-left:60px;padding-right:60px}.default-py{padding-top:88px;padding-bottom:88px}}.font-inter{font-family:'Inter', sans-serif}.btn-primary{padding-left:1.25rem;padding-right:1.25rem;padding-top:0.75rem;padding-bottom:0.75rem;background-color:var(--color-primary);color:var(--color-dark);border-radius:9999px;font-weight:500;transition:background-color 0.2s;cursor:pointer}.btn-primary:hover{background-color:rgba(42, 191, 163, 0.8)}.btn-secondary{padding-left:1.25rem;padding-right:1.25rem;padding-top:0.75rem;padding-bottom:0.75rem;background-color:white;color:var(--color-dark);border-radius:9999px;font-weight:500;transition:background-color 0.2s;cursor:pointer}.btn-secondary:hover{background-color:rgba(255, 255, 255, 0.8)}.blog-rich-text{blockquote {\n margin-bottom: 16px;\n border-left: 3px solid #2abfa3;\n padding-left: 8px;\n font-size: 23px;\n font-weight: 500;\n }\n h1,\n h2,\n h3,\n h4,\n h5,\n h6 {\n font-weight: 700;\n line-height: 1.25;\n margin: 48px 0 12px 0;\n }\n h1 {\n font-size: 39.8px;\n }\n h2 {\n font-size: 33.2px;\n }\n h3 {\n font-size: 27.6px;\n }\n h4 {\n font-size: 23.02px;\n }\n img {\n margin: 0 auto 16px;\n width: 100%;\n }\n ul {\n margin-bottom: 16px;\n font-size: 16px;\n list-style-type: disc;\n list-style-position: inside;\n display: flex;\n flex-direction: column;\n gap: 16px;\n }\n\n ul li:nth-child(1) {\n margin-top: 12px;\n }\n\n ul li li {\n list-style: circle;\n list-style-position: inside;\n }\n\n ol {\n margin-bottom: 16px;\n font-size: 16px;\n list-style-type: decimal;\n list-style-position: inside;\n display: flex;\n flex-direction: column;\n gap: 8px;\n }\n li {\n padding-left: 0.5em;\n text-indent: -0.5em;\n }\n a {\n font-weight: 700;\n color: rgb(28, 135, 201);\n text-decoration: underline;\n }\n a:hover {\n text-decoration: none;\n }\n p {\n font-size: 16px;\n margin-bottom: 20px;\n }\n iframe {\n width: 100%;\n margin-bottom: 24px;\n }}#hubspot-form-container{form {\n width: 100%;\n display: flex;\n flex-direction: column;\n gap: 24px;\n }\n label {\n font-size: 16px;\n color: #c6c9cd;\n }\n input {\n background-color: #0f273a;\n border: 1px solid rgba(255, 255, 255, 0.15);\n width: 100%;\n border-radius: 4px;\n padding: 16px 8px;\n color: white;\n }\n input:focus {\n border: 1px solid #2abfa3;\n outline: none;\n }\n input[type=\"submit\"] {\n font-size: 17px;\n font-weight: 600;\n padding-left: 1.25rem; /* px-5 */\n padding-right: 1.25rem;\n padding-top: 0.75rem; /* py-2 */\n padding-bottom: 0.75rem;\n background-color: var(--color-primary);\n color: var(--color-dark);\n border-radius: 9999px; /* rounded-full */\n font-weight: 500;\n transition: background-color 0.2s;\n cursor: pointer;\n }\n\n .submitted-message p span {\n color: white !important;\n font-size: 19.2px;\n text-align: center;\n }\n .submitted-message a {\n color: rgba(42, 191, 163, 0.8);\n font-size: 19.2px;\n }}#global-growth-form{width:100%;padding-right:0;color:#081A28;label {\n font-size: 14px;\n font-weight: 500;\n margin-bottom: 4px;\n }\n input[type=\"text\"], input[type=\"email\"] {\n border: 1px solid #CAD0D3;\n border-radius: 4px;\n font-size: 14px;\n padding: 8px;\n width: 100%;\n }\n\n .form-columns-2 {\n margin-bottom: 20px;\n display: flex;\n gap: 20px;\n }\n\n .hs-error-msgs {\n color: red;\n }\n\n .hs_email {\n margin-bottom: 20px;\n }\n\n .legal-consent-container {\n display: flex;\n flex-direction: column;\n gap: 10px;\n font-weight: 500;\n font-size: 14px;\n margin-bottom: 32px;\n }\n\n input[type=\"submit\"] {\n text-align: center;\n background-color: #2ABFA3;\n width: 100%;\n padding: 14px;\n border-radius: 100px;\n font-size: 19.2px;\n font-weight: 500;\n cursor: pointer;\n }}@theme inline{--radius-sm: calc(var(--radius) - 4px);--radius-md: calc(var(--radius) - 2px);--radius-lg: var(--radius);--radius-xl: calc(var(--radius) + 4px);--color-background: var(--background);--color-foreground: var(--foreground);--color-card: var(--card);--color-card-foreground: var(--card-foreground);--color-popover: var(--popover);--color-popover-foreground: var(--popover-foreground);--color-primary: var(--primary);--color-primary-foreground: var(--primary-foreground);--color-secondary: var(--secondary);--color-secondary-foreground: var(--secondary-foreground);--color-muted: var(--muted);--color-muted-foreground: var(--muted-foreground);--color-accent: var(--accent);--color-accent-foreground: var(--accent-foreground);--color-destructive: var(--destructive);--color-border: var(--border);--color-input: var(--input);--color-ring: var(--ring);--color-chart-1: var(--chart-1);--color-chart-2: var(--chart-2);--color-chart-3: var(--chart-3);--color-chart-4: var(--chart-4);--color-chart-5: var(--chart-5);--color-sidebar: var(--sidebar);--color-sidebar-foreground: var(--sidebar-foreground);--color-sidebar-primary: var(--sidebar-primary);--color-sidebar-primary-foreground: var(--sidebar-primary-foreground);--color-sidebar-accent: var(--sidebar-accent);--color-sidebar-accent-foreground: var(--sidebar-accent-foreground);--color-sidebar-border: var(--sidebar-border);--color-sidebar-ring: var(--sidebar-ring)}:root{--radius: 0.625rem;--background: #ffffff;--foreground: #081a28;--card: #ffffff;--card-foreground: #081a28;--popover: #ffffff;--popover-foreground: #081a28;--primary: #2abfa3;--primary-foreground: #081a28;--secondary: #f5f5f5;--secondary-foreground: #081a28;--muted: #f5f5f5;--muted-foreground: #73767c;--accent: #f5f5f5;--accent-foreground: #081a28;--destructive: #ef4444;--border: #e5e5e5;--input: #e5e5e5;--ring: #2abfa3;--chart-1: #2abfa3;--chart-2: #ad83fc;--chart-3: #06b6d4;--chart-4: #8b5cf6;--chart-5: #3b82f6;--sidebar: #ffffff;--sidebar-foreground: #081a28;--sidebar-primary: #2abfa3;--sidebar-primary-foreground: #081a28;--sidebar-accent: #f5f5f5;--sidebar-accent-foreground: #081a28;--sidebar-border: #e5e5e5;--sidebar-ring: #2abfa3;--purple-500: #3529be}.dark{--radius: 0.625rem;--background: #081a28;--foreground: #ffffff;--card: #0f273a;--card-foreground: #ffffff;--popover: #081a28;--popover-foreground: #ffffff;--primary: #2abfa3;--primary-foreground: #081a28;--secondary: #0f273a;--secondary-foreground: #ffffff;--muted: #0f273a;--muted-foreground: #a8acb5;--accent: #0f273a;--accent-foreground: #ffffff;--destructive: #ef4444;--border: #2a4255;--input: #2a4255;--ring: #2abfa3;--chart-1: #2abfa3;--chart-2: #ad83fc;--chart-3: #06b6d4;--chart-4: #8b5cf6;--chart-5: #3b82f6;--sidebar: #081a28;--sidebar-foreground: #ffffff;--sidebar-primary: #2abfa3;--sidebar-primary-foreground: #081a28;--sidebar-accent: #0f273a;--sidebar-accent-foreground: #ffffff;--sidebar-border: #2a4255;--sidebar-ring: #2abfa3}@layer base{*{@apply border-border outline-ring/50;}}.dark .text-primary-light{color:#ffffff}.card{position:relative;z-index:10;transition:transform 0.2s ease-in-out;border:1px solid var(--border)}.card:hover{transform:scale(1.05)}.dark .card{background:linear-gradient(to left bottom in oklab, rgb(14, 46, 72) 0px, rgb(10, 33, 50) 100%);border-color:rgba(255,255,255,.1)}.card .dark\\:bg-primary-light{background-color:var(--primary)!important;color:var(--primary)!important;fill:var(--primary)!important}.card [class*=\"bg-primary-light\"]{background-color:var(--primary)!important;color:var(--primary)!important;fill:var(--primary)!important}p{font-weight:500}*{font-weight:var(--font-weight-medium)}h1,h2,h3,h4,h5,h6{font-weight:var(--font-weight-bold)}.content a:not(.card),.prose a:not(.card),[data-content] a:not(.card){border-bottom:1px dashed color-mix(in srgb, var(--purple-500) 50%, transparent)}.dark .content a:not(.card),.dark .prose a:not(.card),.dark [data-content] a:not(.card){border-bottom:1px dashed color-mix(in srgb, white 80%, transparent)}nav a,.nav a,button a,.btn a,a[role=\"button\"],a[class*=\"btn\"],a[class*=\"nav\"]{border-bottom:none}.triangle-bg{position:fixed;bottom:0;right:0;height:80vh;width:auto;pointer-events:none;z-index:0}@media (max-width: 1024px){.triangle-bg{height:70vh}}@media (max-width: 768px){.triangle-bg{display:none}}"},{"filePath":"style.css","content":"@font-face{font-family:'BasisGrotesquePro';src:url('/fonts/BasisGrotesquePro.woff2') format('woff2'),\n url('/fonts/BasisGrotesquePro.woff') format('woff'),\n url('/fonts/BasisGrotesquePro.otf') format('opentype');font-weight:normal;font-style:normal;font-display:swap}@font-face{font-family:'BasisGrotesquePro';src:url('/fonts/BasisGrotesquePro-Bold.woff2') format('woff2'),\n url('/fonts/BasisGrotesquePro-Bold.woff') format('woff'),\n url('/fonts/BasisGrotesquePro-Bold.otf') format('opentype');font-weight:bold;font-style:normal;font-display:swap}@font-face{font-family:'BasisGrotesquePro';src:url('/fonts/BasisGrotesquePro-Italic.woff2') format('woff2'),\n url('/fonts/BasisGrotesquePro-Italic.woff') format('woff'),\n url('/fonts/BasisGrotesquePro-Italic.otf') format('opentype');font-weight:normal;font-style:italic;font-display:swap}:root{--font-family-base: 'BasisGrotesquePro', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif}body,html{font-family:var(--font-family-base)!important}h1,h2,h3,h4,h5,h6{font-family:var(--font-family-base)!important;background:linear-gradient(rgb(53, 41, 190), rgb(7, 27, 90));background-clip:text;-webkit-background-clip:text;-webkit-text-fill-color:transparent;color:transparent}.dark h1,.dark h2,.dark h3,.dark h4,.dark h5,.dark h6{background:none;-webkit-background-clip:unset;-webkit-text-fill-color:unset;color:inherit}[data-theme=\"dark\"] .card{background:linear-gradient(to left bottom in oklab, rgb(14, 46, 72) 0px, rgb(10, 33, 50) 100%);border-color:color-mix(in oklab,var(--color-white) 10%,transparent)}table code{white-space:nowrap}[data-component-part=\"version-select-trigger\"]{border:1.5px solid #28AE97;background-color:rgba(40, 174, 151, 0.10);font-weight:600}[data-component-part=\"version-select-trigger\"]::before{content:\"Version:\";font-weight:400;opacity:0.75}"}],"page":{"pagePath":"api-reference/documents/upload-a-file","slug":"/api-reference/documents/upload-a-file","pageMetadata":{"title":"Upload a File","description":"Create a Document from a file in any of the formats [documented in our knowledge base](/kb/supported-file-formats).\nRequest parameters should be passed as JSON object with the header field `LILT-API`.\n\nFile names in the header can only contain [US-ASCII characters](https://en.wikipedia.org/wiki/ASCII). File names with characters outside of US-ASCII should be [URI encoded](https://en.wikipedia.org/wiki/Percent-encoding) or transliterated to US-ASCII strings.\n\nExample CURL command:\n```bash\n curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\\n --header \"LILT-API: {\\\"name\\\": \\\"introduction.xliff\\\",\\\"pretranslate\\\": \\\"tm+mt\\\",\\\"project_id\\\": 9}\" \\\n --header \"Content-Type: application/octet-stream\" \\\n --data-binary @Introduction.xliff\n```\n\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/documents/files","href":"/api-reference/documents/upload-a-file","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n pre: \"pre\",\n span: \"span\",\n ..._provideComponents(),\n ...props.components\n }, {CodeBlock} = _components;\n if (!CodeBlock) _missingMdxReference(\"CodeBlock\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Create a Document from a file in any of the formats \", _jsx(_components.a, {\n href: \"/kb/supported-file-formats\",\n children: \"documented in our knowledge base\"\n }), \".\\nRequest parameters should be passed as JSON object with the header field \", _jsx(_components.code, {\n children: \"LILT-API\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"File names in the header can only contain \", _jsx(_components.a, {\n href: \"https://en.wikipedia.org/wiki/ASCII\",\n children: \"US-ASCII characters\"\n }), \". File names with characters outside of US-ASCII should be \", _jsx(_components.a, {\n href: \"https://en.wikipedia.org/wiki/Percent-encoding\",\n children: \"URI encoded\"\n }), \" or transliterated to US-ASCII strings.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Example CURL command:\"\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"4\",\n language: \"shellscript\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"shellscript\",\n children: _jsxs(_components.code, {\n language: \"shellscript\",\n numberOfLines: \"4\",\n children: [_jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#953800\",\n \"--shiki-dark\": \"#DCDCAA\"\n },\n children: \" curl\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" -X\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" POST\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" https://api.lilt.com/v2/documents/files?key=API_KEY\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \" \\\\\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" --header\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"LILT-API: {\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"name\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"introduction.xliff\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \",\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"pretranslate\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"tm+mt\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \",\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"project_id\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \"\\\\\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \": 9}\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \" \\\\\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" --header\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" \\\"Content-Type: application/octet-stream\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#CF222E\",\n \"--shiki-dark\": \"#D7BA7D\"\n },\n children: \" \\\\\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#0550AE\",\n \"--shiki-dark\": \"#569CD6\"\n },\n children: \" --data-binary\"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \" @Introduction.xliff\"\n })]\n }), \"\\n\"]\n })\n })\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Upload a File","description":"Create a Document from a file in any of the formats [documented in our knowledge base](/kb/supported-file-formats).\nRequest parameters should be passed as JSON object with the header field `LILT-API`.\n\nFile names in the header can only contain [US-ASCII characters](https://en.wikipedia.org/wiki/ASCII). File names with characters outside of US-ASCII should be [URI encoded](https://en.wikipedia.org/wiki/Percent-encoding) or transliterated to US-ASCII strings.\n\nExample CURL command:\n```bash\n curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\\n --header \"LILT-API: {\\\"name\\\": \\\"introduction.xliff\\\",\\\"pretranslate\\\": \\\"tm+mt\\\",\\\"project_id\\\": 9}\" \\\n --header \"Content-Type: application/octet-stream\" \\\n --data-binary @Introduction.xliff\n```\n\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/documents/files","href":"/api-reference/documents/upload-a-file","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Documents"],"summary":"Upload a File","description":"Create a Document from a file in any of the formats [documented in our knowledge base](/kb/supported-file-formats).\nRequest parameters should be passed as JSON object with the header field `LILT-API`.\n\nFile names in the header can only contain [US-ASCII characters](https://en.wikipedia.org/wiki/ASCII). File names with characters outside of US-ASCII should be [URI encoded](https://en.wikipedia.org/wiki/Percent-encoding) or transliterated to US-ASCII strings.\n\nExample CURL command:\n```bash\n curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\\n --header \"LILT-API: {\\\"name\\\": \\\"introduction.xliff\\\",\\\"pretranslate\\\": \\\"tm+mt\\\",\\\"project_id\\\": 9}\" \\\n --header \"Content-Type: application/octet-stream\" \\\n --data-binary @Introduction.xliff\n```\n\n","operationId":"uploadDocument","parameters":["dbb1d446-e941-4d08-85a9-b0ac87ae06e7","a0ec0f0b-a3a5-4408-a3b2-ffca90c2f288","59875e4c-ac91-4d52-b7bb-72b7c68e0b1d","ac258da6-76a6-434d-b240-48d2c0ef7326","ec950c92-2ca3-4fd5-9651-b0a7232112c2","3d9c83ea-db33-4856-baab-2aaa474cab35","5830a1f1-1d16-476e-be4e-b1b50db51725"],"requestBody":"041f2721-cd07-4fc3-9f5a-a7c93614b719","responses":{"200":"3b26db34-a8d7-4391-abea-2c39c94169a4","401":"5d5fc18a-ec49-4e46-8c23-c40e7679165d","default":"d623947e-f07b-4858-9bac-c2ab310fcb37"},"x-codegen-request-body-name":"body","method":"post","type":"path","servers":["255cf523-65c7-47ce-b352-8c94cfe8315a"],"security":["b7dd0933-ec02-4184-b7be-2d68e51fffc1"],"path":"/v2/documents/files","baseUrlOptions":["https://api.lilt.com"],"title":"Upload a File","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dbb1d446-e941-4d08-85a9-b0ac87ae06e7":{"name":"name","in":"header","description":"A file name.","required":true,"schema":{"type":"string","isRequired":true,"description":"A file name.","uniqueKey":"","typeLabel":"string"}},"a0ec0f0b-a3a5-4408-a3b2-ffca90c2f288":{"name":"project_id","in":"header","description":"A unique Project identifier.","required":true,"schema":{"type":"integer","isRequired":true,"description":"A unique Project identifier.","uniqueKey":"","typeLabel":"integer"}},"59875e4c-ac91-4d52-b7bb-72b7c68e0b1d":{"name":"pretranslate","in":"header","description":"An optional parameter indicating if and how the document will be\npretranslated upon being uploaded.\nThe accepted values are `TM`, or `TM+MT`\n","schema":{"type":"string","description":"An optional parameter indicating if and how the document will be\npretranslated upon being uploaded.\nThe accepted values are `TM`, or `TM+MT`\n","uniqueKey":"","typeLabel":"string"}},"ac258da6-76a6-434d-b240-48d2c0ef7326":{"name":"auto_accept","in":"header","description":"An optional parameter to auto-accept segments with 100% translation\nmemory matches when the `pretranslate` option is also set, or to\nauto-accept any target data that is present when the uploaded file\nis XLIFF. If omitted it will default to your organization settings for `Accept and lock exact matches`,\nif set to `false`, no segments will be auto-accepted.\n","schema":{"type":"boolean","description":"An optional parameter to auto-accept segments with 100% translation\nmemory matches when the `pretranslate` option is also set, or to\nauto-accept any target data that is present when the uploaded file\nis XLIFF. If omitted it will default to your organization settings for `Accept and lock exact matches`,\nif set to `false`, no segments will be auto-accepted.\n","uniqueKey":"","typeLabel":"boolean"}},"ec950c92-2ca3-4fd5-9651-b0a7232112c2":{"name":"case_sensitive","in":"header","description":"An optional parameter to use case sensitive translation memory matching when the `pretranslate`\noption is also enabled. Matches must have identical character-by-character case to qualify as matches.\nDefault value matches your organization settings for `Use case sensitive translation memory matching` setting\n","schema":{"type":"boolean","description":"An optional parameter to use case sensitive translation memory matching when the `pretranslate`\noption is also enabled. Matches must have identical character-by-character case to qualify as matches.\nDefault value matches your organization settings for `Use case sensitive translation memory matching` setting\n","uniqueKey":"","typeLabel":"boolean"}},"3d9c83ea-db33-4856-baab-2aaa474cab35":{"name":"match_attribution","in":"header","description":"An optional parameter to attribute translation authorship of exact matches to the author of the file\nwhen the `pretranslate` option is also enabled. Default value matches your organization settings for `Translation authorship` setting\n","schema":{"type":"boolean","description":"An optional parameter to attribute translation authorship of exact matches to the author of the file\nwhen the `pretranslate` option is also enabled. Default value matches your organization settings for `Translation authorship` setting\n","uniqueKey":"","typeLabel":"boolean"}},"5830a1f1-1d16-476e-be4e-b1b50db51725":{"name":"config_id","in":"header","description":"An optional pararameter to specify an import configuration to\nbe applied when extracting translatable content from this file.\n","schema":{"type":"integer","description":"An optional pararameter to specify an import configuration to\nbe applied when extracting translatable content from this file.\n","uniqueKey":"","typeLabel":"integer"}}},"requestBody":{"description":"The file contents to be uploaded. The entire POST body will be\ntreated as the file.\n","content":{"application/octet-stream":{"schema":{"title":"DocumentUploadBody","type":"string","format":"binary","example":"\u003c?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n\u003cxliff xmlns=\"urn:oasis:names:tc:xliff:document:1.2\">\n...\n\u003c/xliff>","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003c?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n\u003cxliff xmlns=\"urn:oasis:names:tc:xliff:document:1.2\">\n...\n\u003c/xliff>"}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"3b26db34-a8d7-4391-abea-2c39c94169a4":{"description":"A Document object.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"A unique number identifying the Document.","example":46530,"uniqueKey":"id","typeLabel":"integer"},"project_id":{"type":"integer","description":"A unique number identifying the Project.","example":287,"uniqueKey":"project_id","typeLabel":"integer"},"srclang":{"type":"string","description":"An ISO 639-1 language identifier.","example":"en","uniqueKey":"srclang","typeLabel":"string"},"trglang":{"type":"string","description":"An ISO 639-1 language identifier.","example":"de","uniqueKey":"trglang","typeLabel":"string"},"name":{"type":"string","description":"The document name.","example":"Introduction.xliff","uniqueKey":"name","typeLabel":"string"},"import_in_progress":{"type":"boolean","description":"True if the document is currently being imported","example":false,"uniqueKey":"import_in_progress","typeLabel":"boolean"},"import_succeeded":{"type":"boolean","description":"True if the import process succeeded.","example":false,"uniqueKey":"import_succeeded","typeLabel":"boolean"},"import_error_message":{"type":"string","description":"Error message if `import_succeeded=false`","example":"Could not parse XML.","uniqueKey":"import_error_message","typeLabel":"string"},"export_in_progress":{"type":"boolean","description":"True if the document is currently being exported for download","example":false,"uniqueKey":"export_in_progress","typeLabel":"boolean"},"export_succeeded":{"type":"boolean","description":"True if the export process succeeded.","example":false,"uniqueKey":"export_succeeded","typeLabel":"boolean"},"export_error_message":{"type":"string","description":"Error message if `export_succeeded=false`","example":"Could not parse XML.","uniqueKey":"export_error_message","typeLabel":"string"},"is_pretranslating":{"type":"boolean","description":"True if the document is currently being pretranslated.","example":false,"uniqueKey":"is_pretranslating","typeLabel":"boolean"},"status":{"type":"object","properties":{"pretranslation":{"type":"string","description":"","example":"idle","enum":["idle","pending","running"],"uniqueKey":"status.pretranslation","typeLabel":"enum\u003cstring>"}},"description":"A list of translations for the query term.","example":{"pretranslation":"idle"},"uniqueKey":"status","typeLabel":"object"},"translator_email":{"type":"string","description":"The email of the assigned translator.","example":"translator@example.com","uniqueKey":"translator_email","typeLabel":"string"},"reviewer_email":{"type":"string","description":"The email of the assigned reviewer.","example":"reviewer@example.com","uniqueKey":"reviewer_email","typeLabel":"string"},"created_at":{"type":"integer","description":"Time at which the object was created. Measured in seconds since the Unix epoch.","example":1489147692,"uniqueKey":"created_at","typeLabel":"integer"},"updated_at":{"type":"integer","description":"Time at which the object was created. Measured in seconds since the Unix epoch.","example":1489147692,"uniqueKey":"updated_at","typeLabel":"integer"},"is_review_complete":{"type":"boolean","description":"Document review status.","example":true,"uniqueKey":"is_review_complete","typeLabel":"boolean"},"segments":{"type":"array","description":"A list of Segments.","items":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"A unique number identifying the Segment.","example":84480010,"uniqueKey":"segments.items.[INDEX].id","typeLabel":"integer\u003cint64>"},"created_at":{"type":"integer","description":"Time at which the object was created. Measured in seconds since the Unix epoch.","example":1489147692,"uniqueKey":"segments.items.[INDEX].created_at","typeLabel":"integer"},"updated_at":{"type":"integer","description":"Time at which the object was created. Measured in seconds since the Unix epoch.","example":1489147692,"uniqueKey":"segments.items.[INDEX].updated_at","typeLabel":"integer"},"document_id":{"type":"integer","description":"A unique Document identifier.","example":1234,"uniqueKey":"segments.items.[INDEX].document_id","typeLabel":"integer"},"memory_id":{"type":"integer","description":"The Memory with which this Segment is associated.","example":5678,"uniqueKey":"segments.items.[INDEX].memory_id","typeLabel":"integer"},"source":{"type":"string","description":"The source string.","example":"The red bus.","uniqueKey":"segments.items.[INDEX].source","typeLabel":"string"},"srclang":{"type":"string","description":"An ISO 639-1 language code.","example":"en","uniqueKey":"segments.items.[INDEX].srclang","typeLabel":"string"},"target":{"type":"string","description":"The target string.","example":"Le bus rouge.","uniqueKey":"segments.items.[INDEX].target","typeLabel":"string"},"trglang":{"type":"string","description":"An ISO 639-1 language code.","example":"fr","uniqueKey":"segments.items.[INDEX].trglang","typeLabel":"string"},"is_confirmed":{"type":"boolean","description":"The confirmation status.","example":true,"uniqueKey":"segments.items.[INDEX].is_confirmed","typeLabel":"boolean"},"is_reviewed":{"type":"boolean","description":"The review status.","example":true,"uniqueKey":"segments.items.[INDEX].is_reviewed","typeLabel":"boolean"}},"description":"A Segment is a source string and, optionally, its translation. A Segment can be associated with both a Memory and a Document. The Segment object contains additional metadata about the source and target strings.\n","uniqueKey":"segments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"segments","typeLabel":"object[]"}},"description":"A Document is a collection of zero or more Segments.\n","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":46530,"project_id":287,"srclang":"en","trglang":"de","name":"Introduction.xliff","import_in_progress":false,"import_succeeded":false,"import_error_message":"Could not parse XML.","export_in_progress":false,"export_succeeded":false,"export_error_message":"Could not parse XML.","is_pretranslating":false,"status":{"pretranslation":"idle"},"translator_email":"translator@example.com","reviewer_email":"reviewer@example.com","created_at":1489147692,"updated_at":1489147692,"is_review_complete":true,"segments":[{"id":84480010,"created_at":1489147692,"updated_at":1489147692,"document_id":1234,"memory_id":5678,"source":"The red bus.","srclang":"en","target":"Le bus rouge.","trglang":"fr","is_confirmed":true,"is_reviewed":true}]}}},"exampleType":"generated"}},"exampleType":"generated"},"5d5fc18a-ec49-4e46-8c23-c40e7679165d":{"description":"Unauthorized","content":{"application/octet-stream":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"text/plain":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"d623947e-f07b-4858-9bac-c2ab310fcb37":{"description":"Unexpected error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A human-readable message describing the error.","uniqueKey":"message","typeLabel":"string"}},"description":"Response in the event of an unexpected error.\n","example":{"message":"Internal server error."},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal server error."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b7dd0933-ec02-4184-b7be-2d68e51fffc1":{"BasicAuth":{"type":"http","scheme":"basic","scopes":[],"schemeName":"BasicAuth"}}},"servers":{"255cf523-65c7-47ce-b352-8c94cfe8315a":{"url":"https://api.lilt.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[],"schemeName":"BasicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"BasicAuth","name":"Authorization"}],"title":"BasicAuth"}]},"originalFileLocation":"api-reference/openapi-bundled.yaml"},"subdomain":"lilt-db26f913","siteName":"LILT","title":"Upload a File - LILT","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T10:51:13.317Z","originalFileLocation":"api-reference/documents/upload-a-file.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a Document from a file in any of the formats documented in our knowledge base. Request parameters should be passed as JSON object with the header field LILT-API. File names in the header can only contain US-ASCII characters. File names with characters outside of US-ASCII should be URI encoded or transliterated to US-ASCII strings. Example CURL command: bash curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\ --header \u0026quot;LILT-API: {\\\u0026quot;name\\\u0026quot;: \\\u0026quot;introduction.xliff\\\u0026quot;,\\\u0026quot;pretranslate\\\u0026quot;: \\\u0026quot;tm+mt\\\u0026quot;,\\\u0026quot;project_id\\\u0026quot;: 9}\u0026quot; \\ --header \u0026quot;Content-Type: application/octet-stream\u0026quot; \\ --data-binary @Introduction.xliff\">\u003cmeta data-mint-head name=\"application-name\" content=\"LILT\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload a File - LILT\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a Document from a file in any of the formats documented in our knowledge base. Request parameters should be passed as JSON object with the header field LILT-API. File names in the header can only contain US-ASCII characters. File names with characters outside of US-ASCII should be URI encoded or transliterated to US-ASCII strings. Example CURL command: bash curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\ --header \u0026quot;LILT-API: {\\\u0026quot;name\\\u0026quot;: \\\u0026quot;introduction.xliff\\\u0026quot;,\\\u0026quot;pretranslate\\\u0026quot;: \\\u0026quot;tm+mt\\\u0026quot;,\\\u0026quot;project_id\\\u0026quot;: 9}\u0026quot; \\ --header \u0026quot;Content-Type: application/octet-stream\u0026quot; \\ --data-binary @Introduction.xliff\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LILT\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://support.lilt.com/api-reference/documents/upload-a-file\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lilt-db26f913.mintlify.site/_mintlify/api/og/v2?division=Documents\u0026amp;title=Upload+a+File\u0026amp;description=Create+a+Document+from+a+file+in+any+of+the+formats+%5Bdocumented+in+our+knowledge+base%5D%28%2Fkb%2Fsupported-file-formats%29.%0ARequest+parameters+should+be+passed+as+JSON+\u0026amp;theme=83ae01c2301f9e1a58801756\u0026amp;signature=f58bd3544f6e019314f91f725bed463dfb6618288ae408f0bd4dc5ffd04ce443\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Upload a File - LILT\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a Document from a file in any of the formats documented in our knowledge base. Request parameters should be passed as JSON object with the header field LILT-API. File names in the header can only contain US-ASCII characters. File names with characters outside of US-ASCII should be URI encoded or transliterated to US-ASCII strings. Example CURL command: bash curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\ --header \u0026quot;LILT-API: {\\\u0026quot;name\\\u0026quot;: \\\u0026quot;introduction.xliff\\\u0026quot;,\\\u0026quot;pretranslate\\\u0026quot;: \\\u0026quot;tm+mt\\\u0026quot;,\\\u0026quot;project_id\\\u0026quot;: 9}\u0026quot; \\ --header \u0026quot;Content-Type: application/octet-stream\u0026quot; \\ --data-binary @Introduction.xliff\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lilt-db26f913.mintlify.site/_mintlify/api/og/v2?division=Documents\u0026amp;title=Upload+a+File\u0026amp;description=Create+a+Document+from+a+file+in+any+of+the+formats+%5Bdocumented+in+our+knowledge+base%5D%28%2Fkb%2Fsupported-file-formats%29.%0ARequest+parameters+should+be+passed+as+JSON+\u0026amp;theme=83ae01c2301f9e1a58801756\u0026amp;signature=f58bd3544f6e019314f91f725bed463dfb6618288ae408f0bd4dc5ffd04ce443\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lilt-db26f913/kcX7srqayMXLed0E/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LILT\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0B1C56\">\u003clink data-mint-head rel=\"canonical\" href=\"https://support.lilt.com/api-reference/documents/upload-a-file\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/documents/upload-a-file.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://support.lilt.com/#organization\",\"name\":\"LILT\",\"url\":\"https://support.lilt.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lilt-db26f913/UHeYNg6Mxux_MnCF/logo-dark.png?fit=max\u0026auto=format\u0026n=UHeYNg6Mxux_MnCF\u0026q=85\u0026s=ccd8915cfa0f94ab3acc0cd47519228b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://support.lilt.com#website\",\"name\":\"LILT\",\"url\":\"https://support.lilt.com\",\"publisher\":{\"@id\":\"https://support.lilt.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://support.lilt.com/api-reference/documents/upload-a-file#webpage\",\"url\":\"https://support.lilt.com/api-reference/documents/upload-a-file\",\"name\":\"Upload a File\",\"description\":\"Create a Document from a file in any of the formats documented in our knowledge base. Request parameters should be passed as JSON object with the header field LILT-API. File names in the header can only contain US-ASCII characters. File names with characters outside of US-ASCII should be URI encoded or transliterated to US-ASCII strings. Example CURL command: bash curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\\\ --header \\\"LILT-API: {\\\\\\\"name\\\\\\\": \\\\\\\"introduction.xliff\\\\\\\",\\\\\\\"pretranslate\\\\\\\": \\\\\\\"tm+mt\\\\\\\",\\\\\\\"project_id\\\\\\\": 9}\\\" \\\\ --header \\\"Content-Type: application/octet-stream\\\" \\\\ --data-binary @Introduction.xliff\",\"dateModified\":\"2026-11-03T10:51:13.317Z\",\"isPartOf\":{\"@id\":\"https://support.lilt.com#website\"},\"breadcrumb\":{\"@id\":\"https://support.lilt.com/api-reference/documents/upload-a-file#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://support.lilt.com/api-reference/documents/upload-a-file#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://support.lilt.com/api-reference/languages/retrieve-supported-languages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documents\",\"item\":\"https://support.lilt.com/api-reference/documents/download-a-document\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Upload a File\",\"item\":\"https://support.lilt.com/api-reference/documents/upload-a-file\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://support.lilt.com/api-reference/documents/upload-a-file#apireference\",\"headline\":\"Upload a File\",\"name\":\"Upload a File\",\"description\":\"Create a Document from a file in any of the formats documented in our knowledge base. Request parameters should be passed as JSON object with the header field LILT-API. File names in the header can only contain US-ASCII characters. File names with characters outside of US-ASCII should be URI encoded or transliterated to US-ASCII strings. Example CURL command: bash curl -X POST https://api.lilt.com/v2/documents/files?key=API_KEY \\\\ --header \\\"LILT-API: {\\\\\\\"name\\\\\\\": \\\\\\\"introduction.xliff\\\\\\\",\\\\\\\"pretranslate\\\\\\\": \\\\\\\"tm+mt\\\\\\\",\\\\\\\"project_id\\\\\\\": 9}\\\" \\\\ --header \\\"Content-Type: application/octet-stream\\\" \\\\ --data-binary @Introduction.xliff\",\"url\":\"https://support.lilt.com/api-reference/documents/upload-a-file\",\"mainEntityOfPage\":{\"@id\":\"https://support.lilt.com/api-reference/documents/upload-a-file#webpage\"},\"dateModified\":\"2026-11-03T10:51:13.317Z\",\"publisher\":{\"@id\":\"https://support.lilt.com/#organization\"},\"isPartOf\":{\"@id\":\"https://support.lilt.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LILT\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LILT","nav":{"global":{"anchors":[{"anchor":"AI Research","icon":"books","href":"https://lilt.com/ai-research"},{"anchor":"Blog","icon":"book-open-cover","href":"https://lilt.com/blog"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/kb/what-is-lilt"}]},{"tab":"Self-Managed","versions":[{"version":"v6.1 (latest)","groups":[{"group":" ","pages":[{"group":"Overview","pages":[{"title":"System Architecture","href":"/self-managed/v6.1/lilt-system-architecture"},{"title":"Self-Managed Features","href":"/self-managed/v6.1/self-managed-features"},{"title":"Disk Space Requirements","href":"/self-managed/v6.1/disk-space-requirements"},{"title":"Infrastructure Release Notes","href":"/self-managed/v6.1/infrastructure-release-notes"},{"group":"Release Notes","pages":[{"title":"LILT 5.3 Release Notes","href":"/self-managed/v6.1/5.3.0ReleaseNotes"},{"title":"LILT 5.2 Release Notes","href":"/self-managed/v6.1/2025Q2ReleaseNotes"},{"title":"LILT 5.1 Release Notes","href":"/self-managed/v6.1/2025-q1-lilt-5-1-0-release-notes"},{"title":"2025 LILT February Patch Release Notes","href":"/self-managed/v6.1/february-2025-patch-release-notes"},{"title":"2024 Q4 Release Notes","href":"/self-managed/v6.1/2024-q4-release-what-s-new-in-the-lilt-platform"}]}]},{"group":"System Administration","pages":[{"group":"Installation and Upgrade","pages":[{"title":"Upgrade LILT","href":"/self-managed/v6.1/upgrade-system"},{"title":"Move The System Offline","href":"/self-managed/v6.1/move-the-system-offline"},{"title":"Create Backup","href":"/self-managed/v6.1/create-backup"},{"title":"Restore From Backup","href":"/self-managed/v6.1/restore-from-backup"},{"title":"Instructions To Delete Container Images","href":"/self-managed/v6.1/instructions-to-delete-container-images"},{"title":"Access To MongoDB","href":"/self-managed/v6.1/access-to-mongodb"},{"title":"Install K8S In Offline Environment (Rocky 8)","href":"/self-managed/v6.1/install-k8s-in-offline-environment-rocky-8"},{"title":"Upgrade NVIDIA/CUDA Drivers","href":"/self-managed/v6.1/upgrade-nvidia-cuda-drivers"},{"title":"Upgrade Kubernetes","href":"/self-managed/v6.1/upgrade-kubernetes"},{"title":"Upgrade Kubernetes (AWS EKS)","href":"/self-managed/v6.1/upgrade-kubernetes-aws-eks"},{"title":"Upgrade Third Party Applications","href":"/self-managed/v6.1/upgrade-third-party-applications"},{"title":"Upgrade Elasticsearch Across Major Versions","href":"/self-managed/v6.1/upgrade-elasticsearch"},{"title":"Back Up and Restore Elasticsearch","href":"/self-managed/v6.1/backup-and-restore-elasticsearch"},{"title":"Upgrade Qdrant","href":"/self-managed/v6.1/upgrade-qdrant"},{"title":"Install Package","href":"/self-managed/v6.1/install-package"},{"title":"Install System (AWS EKS)","href":"/self-managed/v6.1/install-system-aws-eks"},{"title":"Provision AWS Infrastructure with Terraform","href":"/self-managed/v6.1/install-aws-terraform-module"},{"title":"Install on an Existing EKS Cluster","href":"/self-managed/v6.1/install-aws-existing-cluster"},{"title":"Install from a Bastion","href":"/self-managed/v6.1/install-from-a-bastion"},{"title":"GPU Profiles And Values Overlays","href":"/self-managed/v6.1/gpu-profiles-and-values-overlays"},{"title":"Secrets And Vault","href":"/self-managed/v6.1/secrets-and-vault"},{"title":"install.env Reference","href":"/self-managed/v6.1/install-env-reference"},{"title":"Migrate Object Storage (MinIO to S3)","href":"/self-managed/v6.1/migrate-object-storage-minio-to-s3"},{"title":"Rename the Object Storage Bucket","href":"/self-managed/v6.1/rename-object-storage-bucket"},{"title":"Migrate Database (MySQL to RDS)","href":"/self-managed/v6.1/migrate-database-mysql-to-rds"},{"title":"AWS Access Requirements","href":"/self-managed/v6.1/aws-required-permissions"},{"title":"Install System (Amazon Linux 2023 Or Rocky 8/9)","href":"/self-managed/v6.1/install-system-amazon-linux-2023-or-rocky-8-9"}]},{"group":"System Configuration","pages":[{"title":"Enable/Disable Features","href":"/self-managed/v6.1/enable-features"},{"group":"Language Models","pages":[{"title":"Language Models","sidebarTitle":"Overview","href":"/self-managed/v6.1/v2-language-models"},{"title":"Configuring GPU Worker Counts In LILT","href":"/self-managed/v6.1/configuring-gpu-worker-counts-in-lilt"},{"title":"Self-Managed Hardware Requirements","href":"/self-managed/v6.1/self-managed-hardware-requirements"}]},{"title":"Syncing Language Data","href":"/self-managed/v6.1/sync-language-data"},{"title":"Resource Metrics","href":"/self-managed/v6.1/resource-metrics"},{"title":"Generate Evaluation Metrics (WPA, BLEU)","href":"/self-managed/v6.1/generate-evaluation-metrics-wpa-bleu"},{"title":"Single Sign On (SSO) For Self-Managed","href":"/self-managed/v6.1/single-sign-on-sso"},{"title":"Set Custom Domain And Certificates","href":"/self-managed/v6.1/set-custom-domain-and-certificates"},{"title":"Using S3 instead of MinIO","href":"/self-managed/v6.1/using-s3-instead-of-minio"},{"title":"Trusting a Custom CA for S3 Storage","href":"/self-managed/v6.1/custom-ca-for-s3"},{"title":"Using Amazon RDS Instead of Local MySQL","href":"/self-managed/v6.1/using-rds-instead-of-mysql"},{"title":"Dataflow Analytics Pipeline","href":"/self-managed/v6.1/dataflow-analytics"},{"title":"Configuring the Internal OCR Provider","href":"/self-managed/v6.1/configuring-internal-ocr-provider"},{"title":"SMTP Email Notifications","href":"/self-managed/v6.1/smtp-email-notifications"},{"title":"Scheduling Maintenance-Window Banners","href":"/self-managed/v6.1/maintenance-windows"},{"title":"Enable Incompatible Browsers","href":"/self-managed/v6.1/enable-incompatible-browsers"},{"title":"Create User/Organization","href":"/self-managed/v6.1/create-user-organization"},{"title":"Custom Role For Instant Translate","href":"/self-managed/v6.1/custom-role-for-instant-translate"},{"title":"Migrate Flannel To Calico","href":"/self-managed/v6.1/migrate-flannel-to-calico"},{"title":"Node Labels","href":"/self-managed/v6.1/node-labels"},{"title":"SRX Upload Documentation","href":"/self-managed/v6.1/srx-upload-documentation"},{"title":"User Domains Documentation","href":"/self-managed/v6.1/user-domains-documentation"},{"title":"Create ImagePullSecrets","href":"/self-managed/v6.1/create-imagepullsecrets"},{"group":"Connectors","pages":[{"title":"Connectors","sidebarTitle":"Overview","href":"/kb/connectors"},{"title":"Connector Login Credentials","href":"/self-managed/v6.1/connector-login-credentials"},{"title":"OneDrive Configuration","href":"/self-managed/v6.1/onedrive-configuration"}]}]},{"title":"Troubleshooting","href":"/self-managed/v6.1/deleting"}]},{"group":"System Use","pages":[{"group":"Project Management","pages":[{"title":"Navigation In The Platform","href":"/self-managed/v6.1/new-navigation-in-the-lilt-platform"},{"title":"Creating Jobs","href":"/self-managed/v6.1/creating-jobs"},{"title":"Navigating The Jobs Page","href":"/kb/navigating-the-jobs-list"},{"title":"Navigating The Projects List","href":"/kb/navigating-the-projects-list"},{"title":"Project View","href":"/kb/project-view"},{"title":"Project Delivery","href":"/kb/project-delivery"},{"title":"Project Settings","href":"/kb/project-settings"},{"title":"Project Custom Properties","href":"/kb/project-custom-properties"},{"title":"Reference Materials","href":"/kb/reference-materials"},{"title":"Document Actions","href":"/kb/document-actions"},{"title":"Bulk Document Actions","href":"/kb/bulk-document-actions"},{"title":"Accepting Document Assignments","href":"/kb/accepting-document-assignments"},{"title":"Setting Deadlines","href":"/kb/due-dates-for-jobs-projects-documents"},{"title":"Review Sampling","href":"/kb/review-sampling"},{"title":"Mandatory Batch QA","href":"/kb/mandatory-batch-qa-check"},{"title":"Project Manager Guide","href":"/kb/lilt-translate-guide-for-project-managers"},{"title":"Image File Translation","href":"/self-managed/v6.1/image-file-translation-self-managed"},{"title":"Linguist Homepage","href":"/kb/lilt-linguist-homepage"},{"title":"Workflows","href":"/kb/lilt-workflows"}]},{"group":"Translate","pages":[{"title":"Introduction To LILT Translation","href":"/self-managed/v6.1/introduction-to-lilt-translation"},{"title":"Translating Documents","href":"/kb/translating-documents"},{"title":"Segment Comments and Error Flagging","href":"/kb/segment-comments"},{"title":"Segment State Indicators","href":"/kb/segment-state-indicators"},{"title":"Split \u0026 Merge Segments","href":"/kb/split-merge-segments"},{"title":"Tags \u0026 Formatting","href":"/kb/tags-formatting"},{"title":"Non-Translatables","href":"/kb/non-translatables"},{"title":"Bi-Directional Text Marks","href":"/kb/bi-directional-text-marks"},{"title":"Source Highlighting Tool","href":"/kb/source-highlighting-tool"},{"title":"Hotkeys","href":"/kb/hotkeys"},{"title":"Segment Context","href":"/kb/segment-context"},{"title":"Concordance","href":"/kb/concordance"},{"title":"Terminology","href":"/kb/terminology"},{"title":"Find \u0026 Replace","href":"/kb/find-replace"},{"title":"Document Navigation Tab","href":"/kb/document-navigation-tab"},{"title":"Preview mode","href":"/kb/monolingual-preview"},{"title":"Overwrite Confirmed Segments","href":"/kb/auto-propagation"},{"title":"Custom QA","href":"/self-managed/v6.1/custom-qa"},{"title":"AI Only User Role","href":"/kb/instant-translate-homepage"},{"title":"ICU Support","href":"/self-managed/v6.1/icu-support"}]},{"title":"Data Cleanup \u0026 Building Data Sources","href":"/self-managed/v6.1/data-cleanup-building-memories"},{"title":"Data Source/Terminology Management","href":"/self-managed/v6.1/memory-terminology-management"},{"group":"Manage","pages":[{"group":"Analytics","pages":[{"title":"Job Stats","href":"/kb/job-stats"},{"title":"Analytics","href":"/kb/lilt-analytics-v2"},{"title":"Revision Reports","href":"/kb/how-to-read-revision-reports"},{"title":"Volume and User Activity","href":"/self-managed/v6.1/volume-and-user-activity"}]},{"title":"Organization Settings","href":"/kb/organization-settings"},{"title":"Feature Flag Reference","href":"/kb/feature-flags"},{"title":"File Loaders","sidebarTitle":"Overview","href":"/kb/lilt-file-loaders"}]},{"group":"Create","pages":[{"title":"Create","sidebarTitle":"Overview","href":"/kb/lilt-create"}]}]},{"group":"Compliance","pages":[{"title":"Information Assurance (IA)","href":"/self-managed/v6.1/information-assurance-ia"},{"title":"Audit Logs","href":"/self-managed/v6.1/audit-logs"},{"title":"Brute Force Protection","href":"/self-managed/v6.1/brute-force-protection"},{"title":"Encryption And Access Control","href":"/self-managed/v6.1/encryption-and-access-control"}]},{"group":"Quick User Guides","pages":[{"title":"Quick Start Guide","href":"/self-managed/v6.1/quick-start-guide-w-videos"},{"title":"Manage Memory and Termbase","href":"/self-managed/v6.1/manage-memory-and-termbase"}]}]}]}]},{"tab":"API Reference","groups":[{"group":"Docs","pages":[{"title":"Introduction","href":"/developers/introduction"},{"title":"Quickstart","href":"/developers/quickstart"},{"group":"Guides","pages":[{"title":"Create Content","href":"/developers/guides/create-new-content"},{"title":"Connect Systems To Workflows","href":"/developers/guides/connect-systems-to-workflows"},{"title":"Webhooks","href":"/developers/guides/webhooks"},{"group":"Manage Content","pages":[{"title":"Create A Data Source","href":"/developers/guides/manage-content/create-a-datasource"},{"title":"Data Source Management","href":"/developers/guides/manage-content/tm-query"}]},{"group":"Translate Content","pages":[{"title":"AI Translation","href":"/developers/guides/translate-content/instant-translate"},{"title":"Verified Translation","href":"/developers/guides/translate-content/verified-translation"}]},{"group":"Upload Files","pages":[{"title":"Cloud Upload API Documentation","href":"/developers/guides/upload/file-upload"}]},{"title":"API Rate Limits","href":"/developers/guides/rate-limits"}]}]},{"group":"API Reference","pages":[{"group":"Languages","pages":[{"title":"Retrieve supported languages","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/languages","href":"/api-reference/languages/retrieve-supported-languages"}]},{"group":"Memories","pages":[{"title":"Retrieve a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/memories","href":"/api-reference/memories/retrieve-a-memory"},{"title":"Update the name of a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml put /v2/memories","href":"/api-reference/memories/update-the-name-of-a-memory"},{"title":"Create a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/memories","href":"/api-reference/memories/create-a-memory"},{"title":"Delete a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/memories","href":"/api-reference/memories/delete-a-memory"},{"title":"Query a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/memories/query","href":"/api-reference/memories/query-a-memory"},{"title":"File import for a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/memories/import","href":"/api-reference/memories/file-import-for-a-memory"},{"title":"Termbase export for a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/memories/termbase/export","href":"/api-reference/memories/termbase-export-for-a-memory"},{"title":"Termbase download for a Memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/memories/termbase/download","href":"/api-reference/memories/termbase-download-for-a-memory"},{"title":"Delete a segment from a memory.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/memories/segment","href":"/api-reference/memories/delete-a-segment-from-a-memory"}]},{"group":"Segments","pages":[{"title":"Retrieve a Segment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/segments","href":"/api-reference/segments/retrieve-a-segment"},{"title":"Update a Segment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml put /v2/segments","href":"/api-reference/segments/update-a-segment"},{"title":"Create a Segment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/segments","href":"/api-reference/segments/create-a-segment"},{"title":"Delete a Segment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/segments","href":"/api-reference/segments/delete-a-segment"},{"title":"Unaccept and unlock segments","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/segments/review/unlock","href":"/api-reference/segments/unaccept-and-unlock-segments"},{"title":"Tag a Segment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/segments/tag","href":"/api-reference/segments/tag-a-segment"}]},{"group":"Translate","pages":[{"title":"Translate a segment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/translate","href":"/api-reference/translate/translate-a-segment"},{"title":"Translate a segment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/translate","href":"/api-reference/translate/translate-a-segment-1"},{"title":"Monitor file translation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/translate/file","href":"/api-reference/translate/monitor-file-translation"},{"title":"Translate a File","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/translate/file","href":"/api-reference/translate/translate-a-file"},{"title":"Download translated file","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/translate/files","href":"/api-reference/translate/download-translated-file"}]},{"group":"Create","pages":[{"title":"Get Lilt Create content","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/create","href":"/api-reference/create/get-lilt-create-content"},{"title":"Generate new Lilt Create content","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/create","href":"/api-reference/create/generate-new-lilt-create-content"},{"title":"Get Lilt Create content by ID.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/create/{contentId}","href":"/api-reference/create/get-lilt-create-content-by-id"},{"title":"Update Lilt Create content","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml put /v2/create/{contentId}","href":"/api-reference/create/update-lilt-create-content"},{"title":"Delete Lilt Create content","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/create/{contentId}","href":"/api-reference/create/delete-lilt-create-content"}]},{"group":"Workflows","pages":[{"title":"Retrieve workflow templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/workflows/templates","href":"/api-reference/workflows/retrieve-workflow-templates"}]},{"group":"Jobs","pages":[{"title":"Retrieve all Jobs","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/jobs","href":"/api-reference/jobs/retrieve-all-jobs"},{"title":"Create a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/jobs","href":"/api-reference/jobs/create-a-job"},{"title":"Retrieve a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/jobs/{jobId}","href":"/api-reference/jobs/retrieve-a-job"},{"title":"Update a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml put /v2/jobs/{jobId}","href":"/api-reference/jobs/update-a-job"},{"title":"Delete a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/jobs/{jobId}","href":"/api-reference/jobs/delete-a-job"},{"title":"Retrieve Job Leverage Stats","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/jobs/{jobId}/stats","href":"/api-reference/jobs/retrieve-job-leverage-stats"},{"title":"Archive a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/jobs/{jobId}/archive","href":"/api-reference/jobs/archive-a-job"},{"title":"Unarchive a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/jobs/{jobId}/unarchive","href":"/api-reference/jobs/unarchive-a-job"},{"title":"Deliver a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/jobs/{jobId}/deliver","href":"/api-reference/jobs/deliver-a-job"},{"title":"Reactivate a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/jobs/{jobId}/reactivate","href":"/api-reference/jobs/reactivate-a-job"},{"title":"Export a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/jobs/{jobId}/export","href":"/api-reference/jobs/export-a-job"},{"title":"Download a Job","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/jobs/{jobId}/download","href":"/api-reference/jobs/download-a-job"}]},{"group":"Projects","pages":[{"title":"Retrieve a Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/projects","href":"/api-reference/projects/retrieve-a-project"},{"title":"Create a Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/projects","href":"/api-reference/projects/create-a-project"},{"title":"Delete a Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/projects","href":"/api-reference/projects/delete-a-project"}]},{"group":"Documents","pages":[{"title":"Download a Document","description":"Export a Document that has been translated in the Lilt web application.\nAny Document can be downloaded in XLIFF 1.2 format, or can be retrieved in its original uploaded format by setting `is_xliff=false`.\nThis endpoint will fail if either (a) export or (b) pre-translation operations are in-progress. The status of those operations can be determined by retrieving the Document resource.\nExample CURL command:\n```bash\n curl -X GET https://api.lilt.com/v2/documents/files?key=API_KEY\u0026id=274 -o from_lilt.xliff\n```\n\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/documents/files","href":"/api-reference/documents/download-a-document"},{"title":"Upload a File","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/documents/files","href":"/api-reference/documents/upload-a-file"},{"title":"Pretranslate Documents","description":"Pretranslate one or more Documents using translation memory (TM) and,\noptionally, machine translation (MT). Only documents that are not\ncurrently importing/exporting and are not already pretranslating will\nbe pretranslated; the response always reflects the current state of\nevery requested Document id, whether or not it was eligible.\n\nThis is an asynchronous operation. The endpoint returns immediately\nwith a `202` response once pretranslation has been queued; poll the\nDocument resource (or the `is_pretranslating` / `status.pretranslation`\nfields it returns) to see when pretranslation has finished.\n\nThis endpoint is subject to a per-organization rate limit. See the\n[API Rate Limits guide](/developers/guides/rate-limits) for details on\nhow to read `429` responses and batch requests efficiently by passing\nmultiple document ids in a single call.\n\nExample CURL:\n```bash\ncurl -X POST 'https://api.lilt.com/v2/documents/pretranslate?key=API_KEY' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\"id\": [274, 275], \"mode\": \"TM+MT\", \"auto_accept\": true}'\n```\n\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/documents/pretranslate","href":"/api-reference/documents/pretranslate-documents"}]},{"group":"Files","pages":[{"title":"Retrieve a File","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/files","href":"/api-reference/files/retrieve-a-file"},{"title":"Upload a File","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/files","href":"/api-reference/files/upload-a-file"},{"title":"Delete a File","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/files","href":"/api-reference/files/delete-a-file"},{"title":"Download file","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/files/download","href":"/api-reference/files/download-file"},{"title":"Add Label to File","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/files/labels","href":"/api-reference/files/add-label-to-file"},{"title":"Remove Label from File","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/files/labels","href":"/api-reference/files/remove-label-from-file"}]},{"group":"Uploads","pages":[{"title":"Get All Pending Uploads or specific list of uploads by ids or statuses","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/upload","href":"/api-reference/uploads/get-all-pending-uploads-or-specific-list-of-uploads-by-ids-or-statuses"},{"title":"Get Upload by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/upload/{uploadId}","href":"/api-reference/uploads/get-upload-by-id"},{"title":"Get S3 Upload Parameters","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/upload/s3/params","href":"/api-reference/uploads/get-s3-upload-parameters"},{"title":"Initiate File Upload to Cloud Storage","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/upload/s3/params","href":"/api-reference/uploads/initiate-file-upload-to-cloud-storage"},{"title":"Initiate Multipart Upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/upload/s3/multipart","href":"/api-reference/uploads/initiate-multipart-upload"},{"title":"Complete Multipart Upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/upload/s3/multipart/{uploadId}/complete","href":"/api-reference/uploads/complete-multipart-upload"},{"title":"Sign Upload Part","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/upload/s3/multipart/{uploadId}/{partNumber}","href":"/api-reference/uploads/sign-upload-part"},{"title":"Cancel Multipart Upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/upload/s3/multipart/{uploadId}","href":"/api-reference/uploads/cancel-multipart-upload"}]},{"group":"Webhook Configuration","pages":[{"title":"Retrieve a list of Webhook Configurations.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v3/connectors/configuration/webhooks","href":"/api-reference/webhook-configuration/retrieve-a-list-of-webhook-configurations"},{"title":"Creates a new Webhook Configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v3/connectors/configuration/webhooks","href":"/api-reference/webhook-configuration/creates-a-new-webhook-configuration"},{"title":"Retrieve a specific Webhook Configuration by ID.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v3/connectors/configuration/webhooks/{id}","href":"/api-reference/webhook-configuration/retrieve-a-specific-webhook-configuration-by-id"},{"title":"Update a specific Webhook Configuration by ID.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml put /v3/connectors/configuration/webhooks/{id}","href":"/api-reference/webhook-configuration/update-a-specific-webhook-configuration-by-id"},{"title":"Delete a specific Webhook Configuration by ID.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v3/connectors/configuration/webhooks/{id}","href":"/api-reference/webhook-configuration/delete-a-specific-webhook-configuration-by-id"}]},{"group":"Domains","pages":[{"title":"Retrieve Domains","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v3/domains","href":"/api-reference/domains/retrieve-domains"}]},{"group":"API Keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/api-keys","href":"/api-reference/api-keys/create-an-api-key"},{"title":"Get an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /v2/api-keys/{id}","href":"/api-reference/api-keys/get-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/api-keys/{id}","href":"/api-reference/api-keys/revoke-an-api-key"},{"title":"Rotate an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /v2/api-keys/{id}/rotate","href":"/api-reference/api-keys/rotate-an-api-key"},{"title":"Remove an API key from listings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml delete /v2/api-keys/{id}/permanent","href":"/api-reference/api-keys/remove-an-api-key-from-listings"}]}]}]}]},"basePath":"","title":"Upload a File - LILT","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}