> ## Documentation Index
> Fetch the complete documentation index at: https://api.livechatai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a language

> Add a language to the chatbot's supportedLanguages. Optionally seeds initial translation overrides for the new language. Fails with 409 if the language is already the default or already in supportedLanguages.



## OpenAPI

````yaml post /api/v2/chatbots/{chatbotId}/translations/languages
openapi: 3.0.1
info:
  title: LiveChatAI API v2
  description: >-
    LiveChatAI API v2 - Build powerful AI-powered customer support experiences.
    This API follows REST principles with predictable, resource-oriented URLs,
    JSON responses, and standard HTTP methods.
  version: 2.0.0
servers:
  - url: https://app.livechatai.com
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/v2/chatbots/{chatbotId}/translations/languages:
    post:
      tags:
        - Translations
      summary: Add a language
      description: >-
        Add a language to the chatbot's supportedLanguages. Optionally seeds
        initial translation overrides for the new language. Fails with 409 if
        the language is already the default or already in supportedLanguages.
      parameters:
        - in: path
          name: chatbotId
          schema:
            type: string
            example: clx1234567890abcdef
          required: true
          description: Unique identifier of the chatbot
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - language
              properties:
                language:
                  type: string
                  example: GERMAN
                  description: >-
                    A predefined language enum value, or a custom uppercase
                    identifier matching ^[A-Z_]{2,50}$
                translations:
                  type: array
                  description: Optional initial translation overrides
                  items:
                    type: object
                    required:
                      - key
                      - value
                    properties:
                      key:
                        type: string
                        example: newMessageToast
                      value:
                        type: string
                        example: Neue Nachricht!
      responses:
        '200':
          description: Language added successfully
        '400':
          description: Bad request
        '401':
          description: Unauthorized access
        '404':
          description: Chatbot not found
        '409':
          description: Language already configured
        '500':
          description: Internal server error occurred
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````