Alterar, padrão e remover
Altera os dados de um idioma da loja, define o idioma padrão e remove um idioma com suas traduções.
Três operações sobre um idioma que a loja já registrou. Todas exigem o privilégio manage_settings. O code na URL é normalizado (pt-br vale pt-BR).
Alterar idioma
/api/v1/admin/languages/{code}AdminAltera nome, direção, ordem ou habilitação
Alteração parcial: só os campos enviados mudam. Serve para desabilitar um idioma sem apagar suas traduções, reabilitá-lo, mudar a ordem no seletor ou sobrescrever nomes e direção.
Parâmetros de caminho
codestringobrigatórioCorpo da requisição
enabledbooleanfalse desabilita, true reabilita. Desabilitar o idioma padrão ou um idioma usado por mercado ativo é recusado.positionintegernameEnOverridestring"") volta ao valor do catálogo.nameNativeOverridestringdirectionOverridestringLTRRTLExemplo de requisição
curl -X PATCH "$BASE_URL/api/v1/admin/languages/fr" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"enabled":false}'{
"code": "fr",
"nameEn": "French",
"nameNative": "Français",
"direction": "LTR",
"locale": "fr-FR",
"enabled": false,
"isDefault": false,
"position": 0,
"createdAt": "2026-07-13T21:39:52.087304Z",
"updatedAt": "2026-10-11T14:10:00.000Z"
}Definir idioma padrão
/api/v1/admin/languages/{code}/set-defaultAdminPromove um idioma habilitado a padrão
O idioma padrão é a fonte do conteúdo: as traduções automáticas partem dele e a vitrine cai nele quando o cliente não escolhe um idioma. Só um idioma é padrão por vez; o anterior perde a marca na mesma operação. Chamar para o idioma que já é padrão não faz nada.
Parâmetros de caminho
codestringobrigatórioA resposta é 204 No Content, sem corpo.
Remover idioma
/api/v1/admin/languages/{code}AdminRemove um idioma e suas traduções da loja
Apaga o registro do idioma na loja junto com todas as traduções da interface e todo o conteúdo traduzido do catálogo naquele idioma. O idioma volta a aparecer no catálogo disponível. Para só tirá-lo da vitrine sem perder o trabalho, prefira desabilitar com PATCH.
Parâmetros de caminho
codestringobrigatórioA resposta é 204 No Content.
Erros
| Status | Quando | Corpo |
|---|---|---|
| 400 | Corpo inválido (alterar) | {"error":"invalid request body","detail":"..."} |
| 401 | Sem token ou token expirado | {"error":"missing authorization header"} |
| 403 | Sem o privilégio manage_settings | {"error":"insufficient privileges","required":"manage_settings"} |
| 404 | Idioma sem registro na loja | {"error":"language not enabled on this tenant"} (alterar, definir padrão) ou {"error":"language not found"} (remover) |
| 409 | Desabilitar ou remover o idioma padrão; desabilitar ou remover idioma usado por mercado ativo; promover idioma desabilitado | {"error":"cannot disable default language","detail":"cannot disable default language"}, {"error":"cannot remove default language",...}, {"error":"language in use by an active market","detail":"market: Brasil"}, {"error":"cannot promote disabled language","detail":"..."} |
| 422 | directionOverride diferente de LTR e RTL | {"error":"direction must be LTR or RTL","detail":"direction must be LTR or RTL"} |