---
title: "Upload translation key screenshot from file"
method: POST
path: "/api/v1/translation-keys/screenshots/bulk"
tags: ["Translation keys"]
---

# Upload translation key screenshot from file

`POST /api/v1/translation-keys/screenshots/bulk`

## Request

- Base URL: `https://api.simplelocalize.io`
- URL: `https://api.simplelocalize.io/api/v1/translation-keys/screenshots/bulk`
- Auth: API key in header `X-SimpleLocalize-Token`
- TypeScript: <https://skmtc.dev/simplelocalize/apis/simplelocalize-api/docs/api/v1/translation-keys/screenshots/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- UploadMultipleScreenshot
  - `base64` string, required
  - `name` string, required
  - `ocr` string[]
  - `translationKeys` UploadScreenshotKeyNamespace[]
    - `key` string, required
    - `namespace` string

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2025-11-12** `0329534cd557`: 2 breaking, 1 warning, 16 info
  - the `base64` request property's minLength was increased from `0` to `1`
  - the `name` request property's minLength was increased from `0` to `1`
  - deleted the `header` request parameter `X-SimpleLocalize-Token`
  - the endpoint scheme security `Project API Key` was added to the API
  - …15 more
- **2025-04-19** `5475c7163be9`: 8 info
  - the `translationKeys/items/namespace` request property's maxLength was increased from `64` to `128`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `402` status
  - added the optional property `code` to the response with the `403` status
  - …4 more
- **2024-09-18** `ad5c27b926e9`: 1 info
  - added the new optional request property `ocr`
- **2023-11-30** `18bfbf87af44`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v1/translation-keys/screenshots/bulk/post.md)

---

[API](https://skmtc.dev/simplelocalize/apis/simplelocalize-api.md) - [All operations](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/revisions/67a25a25863a?raw)