> For the complete documentation index, see [llms.txt](https://docs.epic-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.epic-ai.com/api-dokumentation/chatbot-language-settings.md).

# Chatbot Language Settings

## Retrieves all language settings for a chatbot

> \
> \
> \*\*Required Permission:\*\* \`chatbots.languages.list\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Chatbot language-settings","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/chatbots/{chatbotId}/settings/languages":{"get":{"operationId":"ChatbotLanguageController_getLanguages[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The Id of the chatbot","schema":{"type":"string"}}],"responses":{"200":{"description":"The current language settings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LanguagesResponseDto"}}}},"403":{"description":"Insufficient permissions."}},"summary":"Retrieves all language settings for a chatbot","tags":["Chatbot language-settings"],"description":"\n\n**Required Permission:** `chatbots.languages.list`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"LanguagesResponseDto":{"type":"object","properties":{"languages":{"description":"The language settings object.","allOf":[{"$ref":"#/components/schemas/LanguagesDto"}]},"error":{"type":"string","description":"Optional error message."}}},"LanguagesDto":{"type":"object","properties":{"updated":{"type":"string","description":"The last update timestamp for the language settings."},"languages":{"description":"A list of currently enabled language codes.","type":"array","items":{"type":"string"}},"defaultLanguage":{"type":"string","description":"The default language code for the chatbot."},"translate":{"type":"boolean","description":"Indicates whether translation mode is enabled."},"defaultCluLanguage":{"type":"string","description":"The default language for the CLU (optional)."}},"required":["updated","languages","defaultLanguage","translate"]}}}}
```

## Adds one or more languages to the chatbot

> \
> \
> \*\*Required Permission:\*\* \`chatbots.languages.create\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Chatbot language-settings","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/chatbots/{chatbotId}/settings/languages":{"post":{"operationId":"ChatbotLanguageController_addLanguages[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The Id of the chatbot","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddLanguagesRequestDto"}}}},"responses":{"200":{"description":"The updated language settings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LanguagesResponseDto"}}}},"201":{"description":"","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input data."},"403":{"description":"Insufficient permissions."}},"summary":"Adds one or more languages to the chatbot","tags":["Chatbot language-settings"],"description":"\n\n**Required Permission:** `chatbots.languages.create`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"AddLanguagesRequestDto":{"type":"object","properties":{"languages":{"minItems":1,"description":"A list of language codes to be added.","type":"array","items":{"type":"string"}}},"required":["languages"]},"LanguagesResponseDto":{"type":"object","properties":{"languages":{"description":"The language settings object.","allOf":[{"$ref":"#/components/schemas/LanguagesDto"}]},"error":{"type":"string","description":"Optional error message."}}},"LanguagesDto":{"type":"object","properties":{"updated":{"type":"string","description":"The last update timestamp for the language settings."},"languages":{"description":"A list of currently enabled language codes.","type":"array","items":{"type":"string"}},"defaultLanguage":{"type":"string","description":"The default language code for the chatbot."},"translate":{"type":"boolean","description":"Indicates whether translation mode is enabled."},"defaultCluLanguage":{"type":"string","description":"The default language for the CLU (optional)."}},"required":["updated","languages","defaultLanguage","translate"]}}}}
```

## Removes one or more languages from the chatbot

> \
> \
> \*\*Required Permission:\*\* \`chatbots.languages.delete\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Chatbot language-settings","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/chatbots/{chatbotId}/settings/languages":{"delete":{"operationId":"ChatbotLanguageController_removeLanguage[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The Id of the chatbot","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveLanguagesRequestDto"}}}},"responses":{"200":{"description":"The updated language settings.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LanguagesResponseDto"}}}},"400":{"description":"Invalid input data."},"403":{"description":"Insufficient permissions."}},"summary":"Removes one or more languages from the chatbot","tags":["Chatbot language-settings"],"description":"\n\n**Required Permission:** `chatbots.languages.delete`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"RemoveLanguagesRequestDto":{"type":"object","properties":{"languages":{"minItems":1,"description":"A list of language codes to be removed.","type":"array","items":{"type":"string"}}},"required":["languages"]},"LanguagesResponseDto":{"type":"object","properties":{"languages":{"description":"The language settings object.","allOf":[{"$ref":"#/components/schemas/LanguagesDto"}]},"error":{"type":"string","description":"Optional error message."}}},"LanguagesDto":{"type":"object","properties":{"updated":{"type":"string","description":"The last update timestamp for the language settings."},"languages":{"description":"A list of currently enabled language codes.","type":"array","items":{"type":"string"}},"defaultLanguage":{"type":"string","description":"The default language code for the chatbot."},"translate":{"type":"boolean","description":"Indicates whether translation mode is enabled."},"defaultCluLanguage":{"type":"string","description":"The default language for the CLU (optional)."}},"required":["updated","languages","defaultLanguage","translate"]}}}}
```

## Enables/disables automatic translation mode

> \
> \
> \*\*Required Permission:\*\* \`chatbots.languages.edit\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Chatbot language-settings","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/chatbots/{chatbotId}/settings/languages/translate":{"patch":{"operationId":"ChatbotLanguageController_updateTranslationMode[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The Id of the chatbot","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTranslationModeDto"}}}},"responses":{"200":{"description":"The updated status of the translation mode.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTranslationModeResponseDto"}}}},"400":{"description":"Invalid input data."},"403":{"description":"Insufficient permissions."}},"summary":"Enables/disables automatic translation mode","tags":["Chatbot language-settings"],"description":"\n\n**Required Permission:** `chatbots.languages.edit`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"UpdateTranslationModeDto":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enables or disables the automatic translation mode."}},"required":["enabled"]},"UpdateTranslationModeResponseDto":{"type":"object","properties":{"enabled":{"type":"boolean","description":"The new state of the translation mode."},"error":{"type":"string","description":"Optional error message."}}}}}}
```