Sync translations from locale files

POST

/translations/sync-filesystem

Last modified:2026-10-06 19:37:15

OperationId:SyncFilesystem

Loads translations from the locale files installed on the server that answers the request. Requires Super User scope.

Send project to load one set of files: horizon for the web app, or auth for the login pages. Omit it, or send all, to load both. For each key in a file:

Not in the database: created, along with its copy in common when common lacks the key.

Customized through this API: left alone.

Already present, auth files: left alone, so the web app's text wins on shared keys.

Value changed in the file: updated.

Keys that are no longer in the files are not deleted. For horizon, translator descriptions are also loaded, for keys that already exist. Only files named like en.json or en-US.json are read.

The response lists every change per project and locale, with totals. A project with no locale files on this server is reported with success: false inside projects, with 200. The change is accepted and applied shortly after this response, so a read made immediately after can still show the old value.

An unknown project returns 400 with the list of valid names.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

The changes made, per project and locale, with totals.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

All projectsWeb app filesLogin page files

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/translations/sync-filesystem' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

200 - All projects

Trimmed to one project and one locale.

{
    "success": true,
    "projects": {
        "horizon": {
            "success": true,
            "translations_path": "/opt/app/web/locales/",
            "descriptions_path": "/opt/app/web/locales/descriptions/",
            "locales": {
                "en-US": {
                    "success": true,
                    "file_path": "/opt/app/web/locales/en-US.json",
                    "summary": {
                        "total_keys": 1317,
                        "added": 2,
                        "updated": 1,
                        "unchanged": 1300,
                        "skipped_user_customized": 14,
                        "skipped_secondary": 0
                    },
                    "changes": [
                        {
                            "namespace": "common",
                            "key": "SEARCH_TRANSLATIONS",
                            "action": "added",
                            "value": "Search translations..."
                        },
                        {
                            "namespace": "common",
                            "key": "SET_ACTIVE",
                            "action": "added",
                            "value": "Set Active"
                        },
                        {
                            "namespace": "settings",
                            "key": "TIME_ZONE_LABEL",
                            "action": "updated",
                            "old_value": "Timezone",
                            "new_value": "Time zone"
                        }
                    ],
                    "descriptions": {
                        "success": true,
                        "file_path": "/opt/app/web/locales/descriptions/en-US.json",
                        "summary": {
                            "total_keys": 69,
                            "updated": 1,
                            "not_found": 0,
                            "skipped": 0
                        }
                    }
                }
            }
        }
    },
    "totals": {
        "total_keys": 1317,
        "added": 2,
        "updated": 1,
        "unchanged": 1300,
        "skipped_user_customized": 14,
        "skipped_secondary": 0
    }
}

Modified at 2026-10-06 19:37:15

Delete translations

Get translation descriptions for a locale