File Management

File management endpoints allow you to upload, list, download, and delete translation files. These endpoints support files up to 100MB in size and provide a simple way to manage your translation file storage.

The translation file upload response model

The upload response model contains information about the uploaded file.

Properties

string

A message describing the result of the operation.

string

The name of the uploaded file.

string

The file extension type.

integer

Size of the file in bytes.

timestamp

Timestamp of when the file was uploaded.

The translation file list response model

The list response model contains information about files in a folder.

Properties

array

Array of file objects in the folder.

integer

Total number of files in the folder.

string

The folder path that was listed.

The translation file delete response model

The delete response model confirms the file deletion.

Properties

string

A message describing the result of the operation.

string

The path of the deleted file.

Upload a translation file

POST /files/upload This endpoint allows you to upload a file to be translated. The maximum file size is 100MB.

Required attributes

file

required

The file to upload (max 100MB).

string

required

Storage location for the file.

Optional attributes

string

Organization identifier (header). If not provided, uses your default organization.

curl -X POST https://api.elanlanguages.ai/v1/files/upload \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -F "file=@/path/to/file.txt" \
  -F "folder_path=/translations"

Response

{
  "message": "File uploaded successfully",
  "file_name": "file.txt",
  "file_type": "txt",
  "file_size": 1024,
  "uploaded_at": "2025-12-21T10:30:00.000Z"
}

List translation files

GET /v1/files/list This endpoint allows you to list translation files in a specific folder.

Required attributes

string

required

Directory path for file listing.

Optional attributes

string

Organization identifier (header). If not provided, uses your default organization.

curl -G https://api.elanlanguages.ai/v1/files/list \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -d folder_path="/translations"

Response

{
  "files": [
    {
      "file_name": "file.txt",
      "file_path": "/translations/file.txt",
      "size": 1024,
      "modified_at": "2025-12-21T10:30:00Z"
    }
  ],
  "total": 1,
  "folder_path": "/translations"
}

Download a translation file

GET /v1/files/download This endpoint allows you to download a translation file. File path should have URL-encoded special characters.

Required attributes

string

required

File location (URL encoded).

Optional attributes

string

Organization identifier (header). If not provided, uses your default organization.

curl -G https://api.elanlanguages.ai/v1/files/download \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -d file_path="/translations/file.txt" \
  -o downloaded_file.txt

The file will be downloaded directly. Make sure to properly URL-encode the file_path parameter if it contains special characters.

Get file details

GET /v1/files/details This endpoint allows you to retrieve details about a file, including analysis results such as word count and detected language. You can poll this endpoint after upload to check when background analysis completes (analysis_status changes from pending to completed).

Required attributes

string

required

File location to inspect.

Optional attributes

string

Organization identifier (header). If not provided, uses your default organization.

curl -G https://api.elanlanguages.ai/v1/files/details \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -d file_path="/translations/file.txt"

Response

{
  "id": 1,
  "s3_key": "translations/file.txt",
  "file_name": "file.txt",
  "file_type": "txt",
  "file_size": 1024,
  "mime_type": "text/plain",
  "uploaded_at": "2025-12-21T10:30:00.000Z",
  "word_count": 182,
  "detected_language": "en",
  "detected_language_confidence": 0.98,
  "analysis_status": "completed"
}

Get a file stream URL

GET /v1/files/stream-url This endpoint returns a short-lived presigned GET URL for streaming a file directly from S3. This is useful for media playback, as it allows the browser to range-request (and seek) large files such as videos instead of downloading the whole object through the API.

Required attributes

string

required

Unprefixed file key (the form returned by the upload endpoint).

Optional attributes

string

Organization identifier (header). If not provided, uses your default organization.

curl -G https://api.elanlanguages.ai/v1/files/stream-url \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -d file_path="/translations/file.txt"

The response contains a short-lived presigned URL that can be used to stream the file directly from S3.

Delete a translation file

DELETE /v1/files/delete This endpoint allows you to delete a translation file.

Required attributes

string

required

File location to remove.

Optional attributes

string

Organization identifier (header). If not provided, uses your default organization.

curl -X DELETE https://api.elanlanguages.ai/v1/files/delete \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -d file_path="/translations/file.txt"

Response

{
  "message": "File deleted successfully",
  "deleted_file": "/translations/file.txt"
}

Guides

Jobs & Translation

Resources

Webhooks

Account

The translation file upload response model

Properties

The translation file list response model

Properties

The translation file delete response model

Properties

Upload a translation file

Required attributes

Optional attributes

List translation files

Required attributes

Optional attributes

Download a translation file

Required attributes

Optional attributes

Get file details

Required attributes

Optional attributes

Get a file stream URL

Required attributes

Optional attributes

Delete a translation file

Required attributes

Optional attributes

​The translation file upload response model

​Properties

​The translation file list response model

​Properties

​The translation file delete response model

​Properties

​Upload a translation file

​Required attributes

​Optional attributes

​List translation files

​Required attributes

​Optional attributes

​Download a translation file

​Required attributes

​Optional attributes

​Get file details

​Required attributes

​Optional attributes

​Get a file stream URL

​Required attributes

​Optional attributes

​Delete a translation file

​Required attributes

​Optional attributes

The translation file upload response model

Properties

The translation file list response model

Properties

The translation file delete response model

Properties

Upload a translation file

Required attributes

Optional attributes

List translation files

Required attributes

Optional attributes

Download a translation file

Required attributes

Optional attributes

Get file details

Required attributes

Optional attributes

Get a file stream URL

Required attributes

Optional attributes

Delete a translation file

Required attributes

Optional attributes