crowdin / crowdin/crowdin-api-client-python
Add directoryIds and branchIds to Apply Pre-Translation
- Dominant language
- Python
- Stars
- 69
- Forks
- 39
- Avg merge
- 23h 35m
- Merged PRs (30d)
- 8
Description
The **Apply Pre-Translation** method (`POST /projects/{projectId}/pre-translations`, `api.projects.pre-translations.post`) now supports pre-translating whole directories and branches in file-based projects, in both Crowdin and Crowdin Enterprise:
- New optional request fields `directoryIds` (array of integers) and `branchIds` (array of integers) — all nested files are included.
- `fileIds` is no longer required — it must be provided only when neither `directoryIds` nor `branchIds` is set.
- The pre-translation status/response attributes now also include `directoryIds` and `branchIds`.
Additionally, the path parameter of **Get Pre-Translation Status**, **Edit Pre-Translation**, and **Get Pre-Translation Report** was renamed from `preTranslationId` to `jobIdentifier` (`/projects/{projectId}/pre-translations/{jobIdentifier}`). This is not a wire change, but generated clients and method signatures may reflect the new name.
Client libraries should make `fileIds` optional and expose the new `directoryIds`/`branchIds` request and response fields.
**References:**
- [Apply Pre-Translation](https://support.crowdin.com/developer/api/v2/#operation/api.projects.pre-translations.post)
- [Get Pre-Translation Status](https://support.crowdin.com/developer/api/v2/#operation/api.projects.pre-translations.get)
- Crowdin Enterprise: [Apply Pre-Translation](https://support.crowdin.com/developer/enterprise/api/v2/#operation/api.projects.pre-translations.post)
Contributor guide
Research direction
Start with api.projects.pre-translations.post and the related Get Pre-Translation Status, Edit Pre-Translation, and Get Pre-Translation Report methods. Compare their generated request, response, and method-signature definitions with the referenced API documentation; done means directoryIds and branchIds are exposed, fileIds is optional, and the path parameter uses jobIdentifier.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- api
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100