Skip to content

DOCS-3238 Document Translation Package API (v2) endpoints - #336

Open
dimitrystd wants to merge 3 commits into
masterfrom
DOCS-3238-translation-package-api
Open

DOCS-3238 Document Translation Package API (v2) endpoints#336
dimitrystd wants to merge 3 commits into
masterfrom
DOCS-3238-translation-package-api

Conversation

@dimitrystd

@dimitrystd dimitrystd commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Jira: DOCS-3238 Document Translation Package API (v2) endpoints

Preview

https://api-reference.smartling.com/preview/pr-336/#tag/translations

Test plan

  • npm test passes (same pre-existing, unrelated failures as master)
  • npm run build bundles all 7 new paths and the translations tag correctly
  • Review rendered preview once Jenkins builds this PR

dimitrystd and others added 2 commits September 10, 2026 17:32
Adds spec/translations/ covering the 7 offline-translation endpoints:
create/get translation package, async process status, XLIFF/TMX
download, offline-CAT XLIFF import, and recent import status.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- Rename tag to translations (Translations display name), move it
  after Translation quality checks, and generalize its description to
  cover future translations-api endpoints beyond translation packages.
- Drop the per-endpoint Limitations block now duplicated at the tag
  level.
- Use TranslationJobUid/WorkflowStepUid schemas instead of bare
  strings where those identifiers appear.
- Recommend generateTmx=false when a TMX file isn't needed.
- Fix inaccurate async/sync claims: package creation only resolves
  string membership synchronously, the XLIFF itself is generated on
  demand at download time (only TMX generation is actually async), and
  the get-package readiness poll applies only to the translationMemory
  link.
- Remove extendedMode and userUid from the public content-download
  endpoint - both were added for internal Smartling tooling (XLIFF
  metadata export, LQA review of AIT translations) with no customer
  use case.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Comment thread spec/translations/translations_endpoints.yaml Outdated
Comment thread spec/translations/translations_endpoints.yaml Outdated
Comment thread spec/translations/translations_endpoints.yaml Outdated
Comment thread spec/openapi.yaml Outdated
Address review feedback: drop parenthetical mentions of Trados, MemoQ,
Phrase, and Wordfast in favor of generic "external CAT tools" language.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants