---
title: "Delete translation keys in bulk"
method: DELETE
path: "/api/v1/translation-keys/bulk"
tags: ["Translation keys"]
---

# Delete translation keys in bulk

`DELETE /api/v1/translation-keys/bulk`

## Request

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

Deletes translation keys for a project. In the same manner as the single key delete endpoint.

It doesn't throw an error if translation key doesn't exist, but it returns a list of failures.

You can delete up to 100 translation keys at once.

## Request body

- DeleteTranslationKeyBulkRequestV2
  - `translationKeys` DeleteTranslationKeyRequestV2[]
    - `key` string, required
    - `namespace` string

## Response `200`

OK

- object
  - `msg` string
  - `status` integer
  - `data` DeleteTranslationKeyBulkResponseV2
    - `failures` Failure[]
      - `entry` UpdateTranslationRequestV2
        - `key` string, required
        - `language` string, required
        - `text` string, required
        - `customerId` string
        - `namespace` string
        - `reviewStatus` 'REVIEWED' | 'NOT_REVIEWED' | ''
      - `message` string

## 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`: 1 breaking, 1 warning, 16 info
  - the `data/failures/items/entry/reviewStatus` response's property type changed from `object` to `string` for status `200`
  - deleted the `header` request parameter `X-SimpleLocalize-Token`
  - the endpoint scheme security `Project API Key` was added to the API
  - the endpoint scheme security `apiKey` was removed from the API
  - …14 more
- **2025-04-19** `5475c7163be9`: 2 breaking, 2 warning, 12 info
  - the `data/failures/items/entry/key` response property's maxLength was unset from `500` for the response status `200`
  - the `data/failures/items/entry/namespace` response property's maxLength was unset from `64` for the response status `200`
  - removed the optional property `data/failures/items/entry/codeDescription` from the response with the `200` status
  - removed the optional property `data/failures/items/entry/description` from the response with the `200` status
  - …12 more
- **2024-05-06** `26bd80894ce2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v1/translation-keys/bulk/delete.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)