Sync translations from locale files

POST

/translations/sync-filesystem

Last modified:2026-10-30 21:15:57

OperationId:SyncFilesystem

Loads translations from the locale files installed on the server that answers the request, creating new keys and updating changed values. Requires Super User scope. Keys customized through this API are left alone, and keys no longer in the files are not deleted.

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. Only files named like en.json or en-US.json are read. A project with no locale files on this server is reported with success: false inside projects. The change is applied shortly after this response, so a read made immediately after can still show the old value.

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-30 21:15:57

Delete translations

Get translation descriptions for a locale