Skip to content
Okta Identity Governance
/
Management APIs
/
/
Retrieve a label

Retrieve a label

Request

OAuth 2.0 scope:
  • okta.governance.labels.read
Admin roles:
  • SUPER_ADMIN

Retrieves a single label

Path
labelIdstringrequired

Unique identifier for the label

GET
/governance/api/v1/labels/{labelId}
curl -i -X GET \
  'https://okta-subdomain.pixtulate.com/governance/api/v1/labels/{labelId}'

Responses

Resource label retrieved successfully

Headers
X-Rate-Limit-Limitinteger, >= 1required

The rate-limit ceiling for the current request

Example:60
X-Rate-Limit-Remaininginteger, >= 0required

The number of requests left for the current rate-limit window

Example:60
X-Rate-Limit-Resetinteger, >= 0required

The time when the rate limit resets, specified in UTC epoch time (in seconds)

Example:1609459200
Bodyapplication/json
labelIdstring, = 20 characters(label-id)required

The ID of a label

namestring, [ 1 .. 50 ] charactersrequired

Key name of the label

valuesArray of objects, <= 10 items(label-value)required

List of label values

Response
{
  "labelId": "lbco3v6xlwdtEX2il1d6",
  "name": "Compliance",
  "values": [
    { … },
    { … }
  ],
  "_links": {
    "self": { … }
  }
}