---
canonical_url: "https://docs.composio.dev/toolkits/simple_localize"
markdown_url: "https://docs.composio.dev/toolkits/simple_localize.md"
product: "platform"
version: null
last_updated: null
---

# SimpleLocalize

SimpleLocalize is a translation management platform for managing localization keys, translations, languages, imports, exports, and hosted environments.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 14
- **Triggers:** 0
- **Slug:** `SIMPLE_LOCALIZE`
- **Version:** 00000000_00

## Tools

### Create Tag

**Slug:** `SIMPLE_LOCALIZE_CREATE_TAG`

Create a project tag for organizing translation keys.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Tag name using 2-16 letters, digits, spaces, underscores, dashes, or dots. |
| `color` | string | No | Six hexadecimal characters without '#', for example 22C373. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Translation Key

**Slug:** `SIMPLE_LOCALIZE_CREATE_TRANSLATION_KEY`

Create one translation key and optional metadata in the connected project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | New translation key. |
| `lock` | boolean | No | Lock editing when true. |
| `tags` | array | No | Up to five existing tag names. |
| `namespace` | string | No | Namespace; empty means the default namespace. |
| `attributes` | object | No | Custom key attributes. |
| `deprecated` | boolean | No | Create the key as deprecated when true. |
| `description` | string | No | Translator-facing context. |
| `characters_limit` | integer | No | Maximum translation length. |
| `code_description` | string | No | Code-facing context. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Translation Keys

**Slug:** `SIMPLE_LOCALIZE_CREATE_TRANSLATION_KEYS`

Create up to 100 translation keys and report every rejected entry; valid entries may still be created when others fail.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `translation_keys` | array | Yes | One to 100 translation keys to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Tag

**Slug:** `SIMPLE_LOCALIZE_DELETE_TAG`

Permanently delete one project tag by its exact name. This destructive action cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_name` | string | Yes | Exact tag name to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Translation Key

**Slug:** `SIMPLE_LOCALIZE_DELETE_TRANSLATION_KEY`

Permanently delete one translation key, including all translations attached to it, by exact key and namespace. WARNING: This destructive action cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | Exact translation key to delete. |
| `namespace` | string | No | Namespace containing the key; use an empty string for the default namespace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Translations

**Slug:** `SIMPLE_LOCALIZE_EXPORT_TRANSLATIONS`

Create downloadable snapshot URLs for project translations in a selected file format. Returns URLs without downloading file bytes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("DEFAULT" | "NEWEST_KEYS_FIRST" | "NEWEST_KEYS_LAST" | "NAMESPACES" | "IMPORT_ORDER") | No | Translation-key ordering. |
| `tags` | array | No | Only export translation keys carrying these tags. |
| `customer_id` | string | No | Customer override ID. Business feature availability may apply. |
| `language_keys` | array | No | Languages to export. Omit to use the provider default. |
| `language_order` | array | No | Language ordering for multi-language formats. |
| `download_format` | string | Yes | Format value returned by LIST_FILE_FORMATS. |
| `download_options` | array | No | Optional export transformations. Each value is sent as a repeated query parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Project Context

**Slug:** `SIMPLE_LOCALIZE_GET_PROJECT_CONTEXT`

Return the connected project and its current languages, tags, and hosting environments so an agent can choose valid identifiers before managing translations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Translation Key

**Slug:** `SIMPLE_LOCALIZE_GET_TRANSLATION_KEY`

Return full metadata for one translation key selected by key and namespace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | Exact translation key to retrieve. |
| `namespace` | string | No | Namespace containing the key; use an empty string for the default namespace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Activity

**Slug:** `SIMPLE_LOCALIZE_LIST_ACTIVITY`

Return a manually selected page of recent project changes for operational visibility.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Zero-based page number. |
| `size` | integer | No | Number of activities to request (1-50). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List File Formats

**Slug:** `SIMPLE_LOCALIZE_LIST_FILE_FORMATS`

Return the file formats currently accepted by SimpleLocalize exports, including multi-language, beta, and deprecation metadata.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Translation Keys

**Slug:** `SIMPLE_LOCALIZE_LIST_TRANSLATION_KEYS`

Search translation keys and return one controllable page of provider summary fields. Use Get Translation Key for detailed metadata such as tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | No | Filter by translation key. |
| `size` | integer | No | Maximum keys in this page. |
| `sort` | string ("last_seen_at" | "modified_at" | "created_at" | "deprecated_at") | No | Provider sort field. |
| `namespace` | string | No | Filter by namespace. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit for the first page and pass it back unchanged to continue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Translations

**Slug:** `SIMPLE_LOCALIZE_LIST_TRANSLATIONS`

Search translations by key, language, text, review state, or namespace and return one page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | No | Filter by translation key. |
| `size` | integer | No | Maximum translations in this page. |
| `text` | string | No | Search translated text (at least 3 characters). |
| `query` | string | No | Provider full translation search query (at least 3 characters). |
| `sort_by` | string | No | Sort field. |
| `language` | string | No | Filter by language key. |
| `base_only` | boolean | No | Return only base translations. |
| `namespace` | string | No | Filter by namespace. |
| `sort_order` | string ("asc" | "desc") | No | Sort direction. |
| `customer_id` | string | No | Filter a customer override. Business feature availability may apply. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. |
| `text_status` | string ("EMPTY" | "NOT_EMPTY") | No | Filter empty or populated translations. |
| `review_status` | string ("REVIEWED" | "NOT_REVIEWED") | No | Filter by review state. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Translation

**Slug:** `SIMPLE_LOCALIZE_SET_TRANSLATION`

Set the text and optional review state for one existing translation key and language.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | Existing translation key. |
| `text` | string | Yes | Translation text. Use an empty string to intentionally clear it. |
| `language` | string | Yes | Target project language key. |
| `namespace` | string | No | Namespace; empty means the default namespace. |
| `customer_id` | string | No | Customer override ID. Business feature availability may apply. |
| `review_status` | string ("REVIEWED" | "NOT_REVIEWED") | No | Optional review state. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Translations

**Slug:** `SIMPLE_LOCALIZE_SET_TRANSLATIONS`

Set 1 to 100 translations in one request. Reports each rejected entry and distinguishes complete success from partial success.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `translations` | array | Yes | Translation updates to apply. Each targets an existing key and language. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |