Skip to content
Okta Identity Governance
/
/My Settings

My Settings

The My Settings API allows end users to manage their governance settings. The response is specifically for the authenticated user (the end user) making the request. Use this API to view and manage your settings, such as appointing a delegate for governance reviews.

Operations

Retrieve my settings

Request

Beta
OAuth 2.0 scope:
  • okta.governance.principalSettings.read

Retrieves the settings for the current authenticated user

curl -i -X GET \
  https://subdomain.okta.com/governance/api/v1/my/settings

Responses

A successful my settings response

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
delegatesobject

My delegates

Response
{
  "delegates": {
    "appointments": [ … ]
  }
}