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

List tasks for a project

Lists tasks associated with a project. Use the filter parameters to narrow results by task state, assignee, type, project, language, key, agency, closure time, or branch, and use search to filter by text. Use page and size to paginate the results.

18 parameters
projectIdintegerrequired
The int64 identifier of the project whose tasks to list.
filterStatearray<string>optional
Include tasks with any of these states: NEW, IN_PROGRESS, FINISHED, or CANCELED.
filterNotStatearray<string>optional
Exclude tasks with any of these states: NEW, IN_PROGRESS, FINISHED, or CANCELED.
filterAssigneearray<integer>optional
Filter by one or more assignee IDs.
filterTypearray<string>optional
Filter by task type: TRANSLATE or REVIEW.
filterIdarray<integer>optional
Filter by one or more task IDs.
filterNotIdarray<integer>optional
Exclude tasks with any of these IDs.
filterProjectarray<integer>optional
Filter by one or more project IDs.
filterNotProjectarray<integer>optional
Exclude tasks associated with any of these project IDs.
filterLanguagearray<integer>optional
Filter by one or more language IDs.
filterKeyarray<integer>optional
Filter by one or more key IDs.
filterAgencyarray<integer>optional
Filter by one or more agency IDs.
filterNotClosedBeforeintegeroptional
Exclude tasks closed before this timestamp.
branchstringoptional
Branch name to filter tasks by. Defaults to the project's default branch when omitted.
pageintegeroptional
Zero-based page index. Defaults to 0 when omitted and must be 0 or greater.
Default:0
sizeintegeroptional
Number of tasks per page. Defaults to 20 when omitted and must be at least 1.
Default:20
sortarray<string>optional
Sorting criteria in `property,(asc|desc)` format; multiple criteria are supported.
searchstringoptional
Text used to search and filter tasks.

5 status codes
200Returns a paginated response containing task objects and page metadata, including the page number, size, total elements, and total pages.
_embeddedobjectoptional
pageobjectoptional
400Returned when the request is invalid, such as when a filter or pagination parameter 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 access 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 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 cannot be found. filterState and filterNotState accept NEW, IN_PROGRESS, FINISHED, or CANCELED; filterType accepts TRANSLATE or REVIEW, and page must be 0 or greater while size must be at least 1.