Tolgee Octri Demo
GET/v2/projects/{projectId}/labels/ids

Get project labels by ID

Lists project labels that match the supplied identifiers. Pass the label IDs in the required id query parameter and use projectId to scope the lookup. The response contains the matching labels.

2 parameters
projectIdintegerrequired
The unique integer identifier of the project containing the labels.
idarray<integer>required
The required array of label identifiers to retrieve.

5 status codes
200Returns an array of matching label objects, each including its `id`, `name`, `color`, and optional `description`.
colorstringrequired
descriptionstringoptional
idintegerrequired
namestringrequired
400Returned when the query parameters are invalid or the required `id` query parameter is missing.
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 you do not have permission to access the project's labels.
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 is not 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 query is invalid, a 401 when authentication is missing or invalid, a 403 when you lack permission, and a 404 when the project is not found. The id query parameter must contain label identifiers, and the projectId path parameter must identify an existing project.