Skip to content

TCM-6557 Update Strings API and add common schemas to api_common.yaml#328

Open
dimitrystd wants to merge 6 commits into
masterfrom
TCM-6557-update-strings-api-part-2
Open

TCM-6557 Update Strings API and add common schemas to api_common.yaml#328
dimitrystd wants to merge 6 commits into
masterfrom
TCM-6557-update-strings-api-part-2

Conversation

@dimitrystd

@dimitrystd dimitrystd commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary

  • New shared schemas in api_common.yaml (usable by all APIs):
    • Schemas: DateTime, FileUri, LocaleId, Hashcode, TranslationJobUid, WorkflowUid, WorkflowStepUid
    • Parameters: offset, limit
    • Improved existing parameters: projectId (added regex pattern + examples), localeId (linked to LocaleId schema + examples)
  • Moved Strings API endpoints and related schemas from openapi.yaml into the dedicated spec/strings/strings-api-v2.yaml
  • Updated strings-api-v2.yaml payloads to align with internal spec: improved descriptions, fixed swapped fileUri/key descriptions in StringInfo and Translation schemas, clarified key nullability

Test plan

  • npm test passes (pre-existing failures on master are unrelated to this branch)
  • npm run build produces a valid bundle
  • Preview at https://api-reference.smartling.com/preview/tcm-6557-update-strings-api-part-2 renders Strings API endpoints correctly
  • New common schemas (LocaleId, Hashcode, etc.) appear in the Components section

🤖 Generated with Claude Code

https://claude.ai/code/session_01EVm9PgBYifHQd5yjAKq32p

dimitrystd and others added 5 commits June 22, 2026 10:17
- Rename path parameter {projectId} to {projectUid} across all four
  strings-api paths (both path keys in openapi.yaml and parameter
  names in the spec file)
- Add strings.maxItems: 100 and fix strings.items.maxLength type
  number -> integer in the create endpoint
- Add uri and authorization fields to the create strings request body
- Add showPlaceholderValues parameter to source-strings and
  translations endpoints (GET params and POST body)
- Raise translations limit maximum from 500 to 10,000

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
- Extract LocaleId as a reusable schema in api_common.yaml with type, pattern, and description
- Update localeId parameter to reference LocaleId schema and add named examples with summaries
- Add summary to projectId example to fix trailing dash in rendered output
- Update targetLocaleId fields in strings-api-v2.yaml to reference LocaleId schema

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
….yaml

Move CreateStringResponse, CreateStringStatusResponse, CreatedString,
StringInfo, StringResponse, Translation, and TranslationResponse schemas
to strings-api-v2.yaml since they are only used by the Strings API.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
…lability

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EVm9PgBYifHQd5yjAKq32p
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EVm9PgBYifHQd5yjAKq32p
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.

1 participant