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

Get a task

Retrieves a specific task from a project by its task number. Use the task details to inspect its state, language, assignees, and progress. The task number is scoped to the specified project.

2 parameters
taskNumberintegerrequired
The int64 task number to retrieve.
projectIdintegerrequired
The int64 identifier of the project containing the task.

5 status codes
200Returns the task object, including its task number, state, language, assignees, description, item counts, and task type.
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 path parameter is invalid.
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 access 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 a task in that project.