crowdin / crowdin/crowdin-api-client-python

Tasks API updates - syncScope, originalWordsCount, and model fixes

Open
#282 0 comments 0 reactions 0 assignees View on GitHub
enhancement good first issue
Dominant language
Python
Stars
69
Forks
39
Avg merge
23h 35m
Merged PRs (30d)
8

Description

Several updates landed on the Tasks API models that typed client libraries should pick up:

**New response fields:**

- `originalWordsCount` (integer) on the Task model — the number of words when the task was created, preserved when source strings are later removed (`wordsCount` reflects the current count). Both Crowdin and Crowdin Enterprise.
- `syncScope` (nullable object: `syncedWords`, `pendingWords`, `skippedWords` — all integers) on the Enterprise task models (project tasks, organization task list, user tasks). It is `null` when the task is fully synced, not shared, or the counterpart is unavailable — **Crowdin Enterprise only**.

**Type fixes:**

- Task `creatorId` corrected from string to **integer**.
- Enterprise Add Task forms: `status` corrected from integer to **string** enum (`todo`, `in_progress`).

**Edit Project Task (Enterprise):** the inter-organizational task patch `path` enum gains `/generateCostEstimate`, `/generateTranslationCost`, and `/reportSettingsTemplateId`.

Affected endpoints: **List/Add/Get/Edit Project Task** (`api.projects.tasks.getMany`/`post`/`get`/`patch`), **List Tasks** (Enterprise organization level, `api.tasks.getMany`), **List User Tasks** (`api.users.tasks.getMany` on crowdin.com).

**References:**
- [List Project Tasks](https://support.crowdin.com/developer/api/v2/#operation/api.projects.tasks.getMany)
- [Edit Task](https://support.crowdin.com/developer/api/v2/#operation/api.projects.tasks.patch)
- Crowdin Enterprise: [List Tasks](https://support.crowdin.com/developer/enterprise/api/v2/#operation/api.tasks.getMany), [Edit Task](https://support.crowdin.com/developer/enterprise/api/v2/#operation/api.projects.tasks.patch)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.