---
title: "Add an element option translation"
method: POST
path: "/dam/elements/{element_id}/element-options/{element_option_id}/translations"
tags: ["DAM: Category: Elements: Options: Translations"]
---

# Add an element option translation

`POST /dam/elements/{element_id}/element-options/{element_option_id}/translations`

## Request

- Base URL: `https://api.kontainer.com/jsonapi/v2`
- URL: `https://api.kontainer.com/jsonapi/v2/dam/elements/{element_id}/element-options/{element_option_id}/translations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kontainer/apis/kontainer-api-documentation/docs/dam/elements/:element_id/element-options/:element_option_id/translations/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `element_id` string, required
- `element_option_id` string, required

## Request body

- object
  - `data` object, required: Content for the element option translation
    - `type` string: Resource Type
    - `attributes` object: Attributes
      - `translation_value` string: Translation value
    - `relationships` object: Relationships
      - `global_variable_value` GlobalVariableValueIdentifierObject
        - `data` object, nullable: Content for the element option translation; null when the translation has no global variable
          - `type` 'global_variable_value', required
          - `id` string, required

## Response `201`

created

- DamElementOptionTranslation
  - `data` DamElementOptionTranslationData, required
    - `id` string, required
    - `type` 'dam_element_option_translation', required
    - `attributes` object, required
      - `translation_value` string
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `meta` object, required: Empty unless the translation was requested as a relationship (relationships=dam_element_option_translation), then it carries global_variable_value_id
      - `global_variable_value_id` string: Empty string when the translation has no global variable value
    - `links` object, required
      - `self` string, uri, required
    - `relationships` object: Relationships
      - `global_variable_value` GlobalVariableValueIdentifierObject
        - `data` object, nullable: Content for the element option translation; null when the translation has no global variable
          - `type` 'global_variable_value', required
          - `id` string, required
      - `dam_element_option` object: Dam Element option
        - `data` DamElementOptionIdentifierObject, required
          - `id` string, required
          - `type` 'dam_element_option', required
  - `included` union[]: The element option and the global variable value, included by default when present
    - union
      - DamElementOption
        - `id` string
        - `type` string
        - `attributes` object
      - GlobalVariableValue
        - `type` 'global_variable_value', required
        - `id` string, required
        - `attributes` object, required
          - `value` string, required
          - `import_value` string, required
          - `property_safe_value` string, required
          - `global_variable_name` string, required: Name of the global variable the value belongs to

## Other responses

- `401`: Unauthorized

---

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