Tolgee Octri Demo
GET/v2/projects/{projectId}/batch-jobs/{id}

Get a batch operation

Retrieves a batch operation by its identifier within a project. Use the identifiers to look up the operation and inspect its status, progress, and any failure message.

2 parameters
idintegerrequired
The batch operation identifier, as a 64-bit integer.
projectIdintegerrequired
The project identifier, as a 64-bit integer.

5 status codes
200Returns the batch operation with its identifier, type, status, progress, total item count, creation and update times, and any available author, activity revision, or error message.
activityRevisionIdintegeroptional
The activity revision id, that stores the activity details of the job
authorobjectoptional
createdAtintegerrequired
The time when the job created
errorMessagestringoptional
If the job failed, this is the error message
idintegerrequired
Batch job id
progressintegerrequired
Total items, that have been processed so far
statusstringrequired
Status of the batch job
Allowed:PENDINGRUNNINGSUCCESSFAILEDCANCELLED
totalItemsintegerrequired
Total items
typestringrequired
Type of the batch job
Allowed:AI_PLAYGROUND_TRANSLATEPRE_TRANSLATE_BT_TMMACHINE_TRANSLATEAUTO_TRANSLATEDELETE_KEYSRESTORE_KEYSHARD_DELETE_KEYSSET_TRANSLATIONS_STATECLEAR_TRANSLATIONSCOPY_TRANSLATIONSTAG_KEYSUNTAG_KEYS
updatedAtintegerrequired
The time when the job was last updated (status change)
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 requested resource.
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 batch operation does not exist.
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 path parameter is invalid. A 401 is returned when the request is unauthenticated, a 403 when the authenticated user lacks access, and a 404 when the project or batch operation does not exist. The id path parameter and projectId path parameter must be 64-bit integer identifiers.