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.

Requires the ReadAccess policy

Responses

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

Code examples

curl -X GET "https://api.contit.cloud/locales" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response 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
  }
]
Try it 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.

Requires the WriteAccess policy

Request body application/json

PropertyTypeRequiredDescription
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

Responses

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

Code examples

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
}'
Example request
{
  "code": "fr",
  "name": "Français",
  "fallbackCode": "en",
  "default": false
}
Example response 200
{
  "code": "fr",
  "name": "Français",
  "fallbackCode": "en",
  "default": false
}
Try it 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.

Requires the WriteAccess policy

Path parameters

NameTypeRequiredDescription
codestringCulture code of the locale to delete

Responses

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

Code examples

curl -X DELETE "https://api.contit.cloud/locales/{code}" \
  -H "X-Api-Key: YOUR_API_KEY"
Example request
DELETE /locales/fr
Try it Live