API reference

Locales

API referencehttps://api.contit.cloud

Locales

Endpoints for managing workspace locale configurations: list, create, update, and delete.

GET /locales

Get all locales

Retrieve all configured locales for the workspace, including fallback chains and the default locale.

Richiede la policy ReadAccess

Risposte

200Success
(array)LocaleModel[]Array of locale configurations
401Unauthorized

Esempi di codice

curl -X GET "https://api.contit.cloud/locales" \
  -H "X-Api-Key: YOUR_API_KEY"
Esempio di risposta 200
[
  {
    "code": "en",
    "name": "English",
    "fallbackCode": null,
    "default": true
  },
  {
    "code": "it",
    "name": "Italiano",
    "fallbackCode": "en",
    "default": false
  },
  {
    "code": "de",
    "name": "Deutsch",
    "fallbackCode": "en",
    "default": false
  }
]
Prova Live
PUT /locales

Create or update locale

Create a new locale or update an existing one (matched by code). If `default` is true, the locale is set as the workspace default. The first locale created is automatically marked as default.

Richiede la policy WriteAccess

Corpo della richiesta application/json

ProprietàTipoObbligatorioDescrizione
code string Culture code (e.g. 'en', 'en-GB'). Unique within the workspace.
name string — Human-readable language name
fallbackCode string — Code of another existing locale used as fallback when a translation is missing
default boolean — If true, set this locale as workspace default

Risposte

200Success — locale created or updated
codestringCulture code
namestringHuman-readable language name
fallbackCodestringFallback locale code
defaultbooleanTrue if this is the workspace default locale
400Bad Request — missing code or unknown fallback
401Unauthorized
404Not Found — workspace does not exist

Esempi di codice

curl -X PUT "https://api.contit.cloud/locales" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "code_value",
  "name": "name_value",
  "fallbackCode": "fallbackCode_value",
  "default": true
}'
Esempio di richiesta
{
  "code": "fr",
  "name": "Français",
  "fallbackCode": "en",
  "default": false
}
Esempio di risposta 200
{
  "code": "fr",
  "name": "Français",
  "fallbackCode": "en",
  "default": false
}
Prova Live
DELETE /locales/{code}

Delete locale

Delete a locale by its code. The default locale cannot be deleted, and a locale referenced as fallback by another locale cannot be deleted until the reference is removed.

Richiede la policy WriteAccess

Parametri del percorso

NomeTipoObbligatorioDescrizione
codestringCulture code of the locale to delete

Risposte

200Success — locale deleted
400Bad Request — cannot delete default locale or locale referenced as fallback
401Unauthorized
404Not Found — locale or workspace does not exist

Esempi di codice

curl -X DELETE "https://api.contit.cloud/locales/{code}" \
  -H "X-Api-Key: YOUR_API_KEY"
Esempio di richiesta
DELETE /locales/fr
Prova Live