Tolgee Octri Demo
POST/v2/projects/{projectId}/tasks/create-multiple-tasks

Create multiple tasks

Creates multiple tasks for a project from a list of task definitions. Each task specifies its assignees, description, keys, language, and type, with optional name, branch, and due date. Use the query filters to determine which keys are included in the tasks.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 parameters · 1 body field
projectIdintegerrequired
The int64 identifier of the project in which to create the tasks.
filterStatearray<string>optional
Include keys with translations in these states: UNTRANSLATED, TRANSLATED, REVIEWED, or DISABLED.
filterOutdatedbooleanoptional
Whether to include keys whose translation is outdated.
filterTaskInStatusarray<string>optional
Filter by task membership using `taskType,status`. Status must be IN_OPEN_TASK, NOT_IN_OPEN_TASK, HAS_BEEN_IN_TASK, or NEVER_IN_TASK; task membership is evaluated for the task language, and conditions for different task types are combined with AND.
filterHasSuggestionsbooleanoptional
Whether to include only keys with an active suggestion in the task language.
filterHasNoSuggestionsbooleanoptional
Whether to include only keys without an active suggestion in the task language.

A list of task definitions. Each task must include its assignees, description, keys, language, and task type.

tasksarray<object>required
Task definitions to create. Each item requires `assignees`, `description`, `keys`, `languageId`, and `type`; its optional `name` must be 3 to 255 characters, and `type` must be TRANSLATE or REVIEW.

5 status codes
200Confirms that the multiple-task creation request completed.
400Returned when a required task field is missing or a value fails validation.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
401Returned when the request is not authenticated.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
403Returned when the authenticated user is not permitted to create tasks in the project.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
404Returned when the project or a referenced resource cannot be found.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional

Error handling

A 400 is returned when the request is invalid; a 401 indicates missing or invalid authentication, and a 403 indicates access is denied. A 404 is returned when the project or a referenced resource cannot be found. The projectId path parameter must identify the project, and every item in tasks must include assignees, description, keys, languageId, and type; type must be TRANSLATE or REVIEW.