Tolgee Octri Demo
PUT/v2/projects/{projectId}/tasks/{taskNumber}

Replace task details

Replaces the specified task's assignees and description, and can also replace its due date and name. Supply assignees and description on each request; the remaining body fields can be omitted. The task is identified by its number within the project.

2 parameters · 4 body fields
taskNumberintegerrequired
The int64 task number of the task to replace.
projectIdintegerrequired
The int64 identifier of the project containing the task.

Replacement task details. Include assignees and description; dueDate and name can also be supplied.

assigneesarray<integer>required
Set of user IDs assigned to the task.
descriptionstringrequired
Task description, from 0 to 2000 characters.
dueDateintegeroptional
Due to date in epoch format (milliseconds).
namestringoptional
Task name, from 3 to 255 characters.

5 status codes
200Returns the updated task object, including its task number, state, language, assignees, description, and progress counts.
agencyobjectoptional
assigneesarray<object>required
authorobjectoptional
baseCharacterCountintegerrequired
baseWordCountintegerrequired
branchNamestringoptional
closedAtintegeroptional
createdAtintegeroptional
descriptionstringrequired
doneItemsintegerrequired
dueDateintegeroptional
languageobjectrequired
namestringoptional
numberintegerrequired
originBranchNamestringoptional
statestringrequired
Allowed:NEWIN_PROGRESSFINISHEDCANCELED
totalItemsintegerrequired
typestringrequired
Allowed:TRANSLATEREVIEW
400Returned when a required field is missing or a value fails validation, such as an invalid name length.
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 update the task.
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 task 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 task cannot be found. The taskNumber path parameter and projectId path parameter must identify the task; assignees and description are required, and name must be 3 to 255 characters when provided.