Org Governance Settings

The Org Governance Settings API allows admins to manage governance settings for their org. Use this API to manage settings for an org, such as whether end users can manage delegates.

Retrieve the org settings
Beta
OAuth 2.0 scopes:
  • okta.governance.settings.read
Admin roles:
  • ACCESS_CERTIFICATIONS_ADMIN
  • ACCESS_REQUESTS_ADMIN

Retrieves the governance settings for the org

Note: You must either have the SUPER_ADMIN role or both the ACCESS_CERTIFICATIONS_ADMIN and ACCESS_REQUESTS_ADMIN roles to retrieve governance settings for the org.

Responses
200

A successful org settings response

401

When authentication fails

403

When authorization fails

429

When the rate limit has been exceeded

500

When there is a server fault due to an unexpected error

get/governance/api/v1/settings
Request samples 
Response samples 
application/json
{
  • "delegates": {
    • "enduser": {
      • "permissions": [
        ]
      }
    }
}
Update the org settings
Beta
OAuth 2.0 scopes: 
  • okta.governance.settings.manage
Admin roles: 
  • ACCESS_CERTIFICATIONS_ADMIN
  • ACCESS_REQUESTS_ADMIN
Updates the governance settings for the org




Note: You must either have the SUPER_ADMIN role or both the ACCESS_CERTIFICATIONS_ADMIN and ACCESS_REQUESTS_ADMIN roles to update the org settings.




Request 
Request Body schema: application/json
required
object
Delegate settings


 
Responses 
200
A successful org settings response


400
A request failed validation


401
When authentication fails


403
When authorization fails


429
When the rate limit has been exceeded


500
When there is a server fault due to an unexpected error


patch/governance/api/v1/settings
Request samples 
application/json
{
  • "delegates": {
    • "enduser": {
      • "permissions": [
        ]
      }
    }
}
Response samples 
application/json
{
  • "delegates": {
    • "enduser": {
      • "permissions": [
        ]
      }
    }
}