translations

Get Runtime Bundle

Build a translation bundle ON DEMAND for the dev SDK.

Auth: ApiKey only (CurrentUser falls through to 401), viewer-equivalent scope required (project:read / write / cdn:write / *) — a read of project content, gated like the REST reads. For env_type='dev' keys, IP/origin allowlist enforced. Response shape mirrors the CDN bundle (nested JSON tree) so the SDK parses base and overlays identically.

surface (task 1716): the dev SDK reads BASE bundles from this authed endpoint, not the CDN, and the endpoint had no overlay shape — so a11y overlays never loaded in dev and the SDK short-circuited them to {}. This serves the SAME sparse overlay build_payload emits for the CDN. Crucially an EMPTY overlay is 200 {}, not a 404: empty != missing, which is why the dev SDK can ask every boot without a false alarm.

get/v1/projects/{project_id}/translations/runtime

Request

  • Base URL: https://api.sonenta.dev
  • URL: https://api.sonenta.dev/v1/projects/{project_id}/translations/runtime
  • Auth: none declared

Path parameters

project_idstring required

Query parameters

languagestring required

BCP-47 language code

namespacestring required

Namespace slug

version_slugstring nullable

Project-version slug. Defaults to the production version.

surfacestring nullable

a11y surface overlay: aria_label | alt_text | screen_reader | plain_language. Omit for the BASE bundle. Returns a SPARSE overlay (only keys with an override for that surface); a surface with no overrides returns 200 with an empty body, NOT a 404.

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.