# 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."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chatcaptain.com/api/api-dokumentation/chatbot-language-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.