Create a key (write)
Add a new key to the project. You may seed its values in one call via the values map. On a protected main branch, target a branch with ?branch= instead — direct main writes are rejected.
Constraints:
- The key must be well-formed: each segment (split on the project’s key separator) may contain only letters, digits,
_and-. - Creating a key that already exists returns 409.
Authorizations
API token: tsu_pat_… (PAT) or tsu_proj_… (project token). The token's granted RBAC permissions determine access; see each operation's x-permission.
Path Parameters
Project id (UUID) or id-embedded path slug.
Query Parameters
Target an open translation branch instead of main. Required when the project's main branch is protected.
Body
Lookup identifier. Segments (split on the project separator) may contain only letters, digits, _ and -.
1 - 500"home.hero.title"
Optional translator-facing context for the key.
1000"Headline shown on the landing page hero."
Up to 20 labels for filtering and organizing keys.
2050Set true to make this a plural key (values are keyed by CLDR plural form).
Optional initial values, keyed by language code. Singular: { "fr": "…" }; plural: { "fr": { "one": "…", "other": "…" } }.

