Tolgee Octri Demo
GET/v2/user-tasks

List tasks for the authenticated user

Lists tasks assigned to or otherwise associated with the authenticated user. Apply filters for task state, type, assignee, project, language, key, agency, branch, or search text, and use page and size to paginate the results.

17 parameters
filterStatearray<string>optional
Filter tasks by state: NEW, IN_PROGRESS, FINISHED, or CANCELED.
filterNotStatearray<string>optional
Exclude tasks with the specified states: NEW, IN_PROGRESS, FINISHED, or CANCELED.
filterAssigneearray<integer>optional
Filter tasks by assignee ID; provide integer IDs.
filterTypearray<string>optional
Filter tasks by type: TRANSLATE or REVIEW.
filterIdarray<integer>optional
Filter tasks by task ID; provide integer IDs.
filterNotIdarray<integer>optional
Exclude tasks with the specified task IDs; provide integer IDs.
filterProjectarray<integer>optional
Filter tasks by project ID; provide integer IDs.
filterNotProjectarray<integer>optional
Exclude tasks associated with the specified project IDs; provide integer IDs.
filterLanguagearray<integer>optional
Filter tasks by language ID; provide integer IDs.
filterKeyarray<integer>optional
Filter tasks by key ID; provide integer IDs.
filterAgencyarray<integer>optional
Filter tasks by agency ID; provide integer IDs.
filterNotClosedBeforeintegeroptional
Exclude tasks closed before the specified timestamp, provided as an integer.
branchstringoptional
Filter tasks by branch name. Defaults to the project's default branch when omitted.
pageintegeroptional
Zero-based page index. Defaults to 0 when omitted.
Default:0
sizeintegeroptional
Number of tasks per page. Must be at least 1. Defaults to 20 when omitted.
Default:20
sortarray<string>optional
Sorting criteria in `property,(asc|desc)` format. You can provide multiple criteria; the default sort order is ascending.
searchstringoptional
Search tasks using the supplied text.

5 status codes
200Returns a page of task objects and pagination metadata, including the page number, page size, total element count, and total page count.
_embeddedobjectoptional
pageobjectoptional
400Returned when a filter, paging value, or sort criterion 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 unauthenticated.
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 cannot access the requested task results.
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 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 a filter, paging value, or sort criterion is invalid. A 401 is returned when the request is unauthenticated, a 403 when the authenticated user cannot access the requested task results, and a 404 when a referenced resource cannot be found. page is a zero-based index and size must be at least 1.