GET/v2/projects/{projectId}/tags

List tags for a project

Lists tags associated with a project. Use search to filter the tags and the pagination parameters to control the result page. Results are sorted by name,ASC by default.

5 parameters
projectIdintegerrequired
The int64 identifier of the project whose tags to list.
searchstringoptional
Text used to filter the returned tags.
pageintegeroptional
Zero-based page index. Defaults to 0 when omitted and must be 0 or greater.
Default:0
sizeintegeroptional
Number of tags 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. Defaults to `name,ASC` when omitted.
Default:["name,ASC"]

5 status codes
200Returns a paginated response containing project tags 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 query 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. The page query parameter must be 0 or greater, and the size query parameter must be at least 1.