Retrieve Machine label values
Retrieve paginated, unique, non-null values currently used for a Machine label key. Labels without the requested key are ignored. Results are ordered by value ascending by default before pagination.
Infrastructure Provider callers receive values from their Provider's Machines. Tenant Admin callers receive values only from Sites where `TargetedInstanceCreation` is effective. For organizations with both roles, Provider scope takes precedence, so privileged Tenant Sites owned by other Providers are excluded. The optional siteId parameter further restricts the result.
Authentication
AuthorizationBearer
```
export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current
```
Path parameters
org
Name of the Org
key
Label key. It must not be empty, consist only of whitespace, or contain the Unicode NUL character (U+0000). Reserved path characters, including /, must be percent-encoded.
Query parameters
siteId
ID of the Site to filter label values by
pageNumber
Page number for pagination query
pageSize
Page size for pagination query
orderBy
Ordering applied before pagination; defaults to VALUE_ASC
Allowed values:
Response headers
X-Pagination
Pagination result in JSON format
Response
OK
Errors
400
Bad Request Error
403
Forbidden Error