Search locations by name
GET/locations/search
Returns a paginated list of locations whose name matches the supplied query term. Results are suitable for autocomplete dropdowns on the Groups list page. Requires the READ_LOCATION permission. Returns an empty result set (200) when the location-search feature is disabled for this environment.
Request
Responses
- 200
- 400
- 401
- 403
Paginated list of matching locations
Invalid request. Validation failures (q length / pagination) and missing tenant-id both return {"errors":[{"httpStatus", "reason", "title", "detail"}]}. Examples: q too short → reason=VALIDATION_ERROR; missing tenant-id → title=Missing Headers.
Unauthorized — missing or invalid bearer token. Body is not a structured ApiError (Quarkus/OIDC challenge; typically empty).
Forbidden — caller lacks the READ_LOCATION permission. Body is ApiError (AuthorizationFilter ForbiddenException → GlobalExceptionMapper), e.g. {"errors":[{"httpStatus":403,"reason":"Forbidden","title":"Request Failed","detail":"An error occurred processing your request"}]}.