---
title: "Upload translation files"
method: POST
path: "/v2/translations/upload"
tags: ["Translations"]
---

# Upload translation files

`POST /v2/translations/upload`

Upload one or more JSON translation files for a specific workflow. Files name must match the locale, e.g. en_US.json. Supports both "files" and "files[]" field names for backwards compatibility.

## Headers

- `idempotency-key` string

## Response `200`

Upload results

- UploadTranslationsResponseDto
  - `totalFiles` number, required — Total number of files processed
  - `successfulUploads` number, required — Number of files successfully uploaded
  - `failedUploads` number, required — Number of files that failed to upload
  - `errors` string[], required — List of error messages for failed uploads

---

[API](https://skmtc.net/novu/apis/novu-api.md) · [All operations](https://skmtc.net/novu/apis/novu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novu/novu-api/revisions/c2b2fa0d5d48/schema)