> ## Documentation Index > Fetch the complete documentation index at: https://support.lilt.com/llms.txt > Use this file to discover all available pages before exploring further. # Upload a File > Upload a File in any of the formats [documented in our knowledge base](/kb/supported-file-formats). Request parameters should be passed in as query string parameters. Example CURL command: ```bash curl -X POST https://api.lilt.com/v2/files?key=API_KEY&name=en_US.json \ --header "Content-Type: application/octet-stream" \ --data-binary @en_US.json ``` Calls to GET /files are used to monitor the language detection results. The API response will be augmented to include detected language and confidence score. The language detection will complete asynchronously. Prior to completion, the `detected_lang` value will be `zxx`, the reserved ISO 639-2 code for "No linguistic content/not applicable". If the language can not be determined, or the detection process fails, the `detected_lang` field will return `und`, the reserved ISO 639-2 code for undetermined language, and the `detected_lang_confidence` score will be `0`. ## OpenAPI ````yaml /api-reference/openapi-bundled.yaml post /v2/files openapi: 3.0.3 info: title: LILT API description: > LILT API Support: https://lilt.atlassian.net/servicedesk/customer/portals The LILT API enables programmatic access to the full-range of LILT backend services including: * Training of and translating with interactive, adaptive machine translation * Large-scale translation memory * The Lexicon (a large-scale termbase) * Programmatic control of the LILT CAT environment * Translation memory synchronization Requests and responses are in JSON format. The REST API only responds to HTTPS / SSL requests. The base url for this REST API is `https://api.lilt.com/`. ## Authentication Requests are authenticated via API key, which requires the Business plan. Requests are authenticated using [HTTP Basic Auth](https://en.wikipedia.org/wiki/Basic_access_authentication). Add your API key as both the `username` and `password`. For development, you may also pass the API key via the `key` query parameter. This is less secure than HTTP Basic Auth, and is not recommended for production use. ## Quotas Our services have a general quota of 4000 requests per minute. Should you hit the maximum requests per minute, you will need to wait 60 seconds before you can send another request. version: v3.0.3 license: name: LILT Platform Terms and Conditions url: https://lilt.com/lilt-platform-terms-and-conditions servers: - url: https://api.lilt.com security: - BasicAuth: [] - ApiKeyAuth: [] paths: /v2/files: post: tags: - Files summary: Upload a File description: >+ Upload a File in any of the formats [documented in our knowledge base](/kb/supported-file-formats). Request parameters should be passed in as query string parameters. Example CURL command: ```bash curl -X POST https://api.lilt.com/v2/files?key=API_KEY&name=en_US.json \ --header "Content-Type: application/octet-stream" \ --data-binary @en_US.json ``` Calls to GET /files are used to monitor the language detection results. The API response will be augmented to include detected language and confidence score. The language detection will complete asynchronously. Prior to completion, the `detected_lang` value will be `zxx`, the reserved ISO 639-2 code for "No linguistic content/not applicable". If the language can not be determined, or the detection process fails, the `detected_lang` field will return `und`, the reserved ISO 639-2 code for undetermined language, and the `detected_lang_confidence` score will be `0`. operationId: uploadFile parameters: - name: name in: query description: A file name. required: true schema: type: string - name: file_hash in: query description: >- A hash value to associate with the file. The MD5 hash of the body contents will be used by default if a value isn't provided. schema: type: string - name: langId in: query description: >- Flag indicating whether to perform language detection on the uploaded file. Default is false. schema: type: boolean - name: project_id in: query description: The project to associate the uploaded file with. schema: type: integer - name: category in: query description: >- The category of the file. The options are `REFERENCE`, or `API`. The default is API. Files with the `REFERENCE` category will be displayed as reference material. schema: type: string - name: labels in: query description: Comma-separated list of labels to add to the uploaded document. schema: type: string - in: query name: job_type description: Specifies the job type when adding this file to a job. required: false schema: type: string enum: - TRANSLATION - PROMPT_RESPONSE requestBody: description: >- The file contents to be uploaded. The entire POST body will be treated as the file. content: application/octet-stream: schema: title: FileUploadBody type: string format: binary example: |- ... required: true responses: '201': description: A SourceFile object. content: application/json: schema: $ref: '#/components/schemas/SourceFile' '401': $ref: '#/components/responses/UnauthorizedError' default: description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: SourceFile: type: object properties: id: type: integer description: A unique number identifying the SourceFile. example: 46530 name: type: string description: The file name. example: en_US.json file_hash: type: string description: >- A unique hash value associated with the file. An MD5 hash of the file content will be used by default. example: 3858f62230ac3c915f300c664312c63f detected_lang: type: string description: Language associated with the file. example: de detected_lang_confidence: type: number description: Confidence score for the language associated with the file. example: 0.7 category: type: string description: >- The category of the file. The options are `REFERENCE`, or `API`. The default is API. Files with the `REFERENCE` category will be displayed as reference material. example: REFERENCE labels: type: array description: The list of labels associated with the file. example: [] items: type: string created_at: type: string description: Time at which the object was created. format: date-time example: '2019-10-16T22:12:34Z' updated_at: type: string description: Time at which the object was created. format: date-time example: '2019-10-16T22:12:34Z' description: >- A SourceFile is an unprocessed source file that can later be added to a project. Error: type: object properties: message: type: string description: A human-readable message describing the error. description: | Response in the event of an unexpected error. example: message: Internal server error. responses: UnauthorizedError: description: Unauthorized content: application/octet-stream: schema: type: string text/plain: schema: type: string securitySchemes: BasicAuth: type: http scheme: basic ApiKeyAuth: type: apiKey name: key in: query ````