Languages and localization
Manage languages, glossary and static text
Runs one localization operation, selected by op. Language and static text changes are live project state (no draft or publish step) and refresh the storefront cache. Glossary entries are translation aids, not storefront content.
Operations:
- add-language (content:write): adds a language by code and languageCode (2-35 characters each; code is lowercased). Re-adding an existing language is a no-op and returns language: null; re-adding a deleted one revives it with its translations.
- delete-language (content:delete, confirm equal to languageId): deletes a language under the project lock and advances the project revision, so drafts captured against the old language set are fenced. A missing or foreign id returns 404 with nothing written.
- static-save (content:write): merges translations (flattened key to value, e.g. cart.title) into language languageId's static text. An empty string removes that key's value. Returns the number of keys sent.
- static-key-default (content:write): sets the default value of static key keyId (max 20,000 characters).
- static-key-delete (content:delete, confirm equal to keyId): deletes a static key.
- glossary-upsert (content:write): creates an entry, or updates entry id when given. sourceTerm (1-200 characters) is required; optional doNotTranslate, caseSensitive (both default false) and notes (max 2,000).
- glossary-delete (content:delete, confirm equal to entryId): deletes a glossary entry.
delete-language returns cacheDelivery: "degraded" when the delete committed but the cache refresh failed. A wrong confirm value returns 400 INVALID_PARAMS.
Required scope: content:write (all operations); delete-language, static-key-delete and glossary-delete also need content:delete
post/projects/{projectId}/localization
Request
- Base URLhttps://studio.weaverse.io/api/v1/content
- AuthHTTP bearer
Request body
Response
Operation result
object required
Changes
No recorded changes to this operation across all 1 revision of this API.