Skip to content

Update the org request settings

Request

OAuth 2.0 scope:
  • okta.accessRequests.condition.manage
Admin roles:
  • ACCESS_REQUESTS_ADMIN

Updates the request settings for the org

Bodyapplication/jsonrequired
subprocessorsAcknowledgedboolean(subprocessors-acknowledged)

Indicates that Access Requests provisioning was triggered by the customer (such as in Govern Okta admin roles)

resourceCatalogVisibilityobject(resource-catalog-visibility)

Visibility settings for access to the resource catalog.

This setting controls the Request Access button visible in the End-User Dashboard. For the Unified requester experience, this setting also controls the Resource Catalog links and search options from the Okta Access Request app, Slack, or Microsoft Teams.

integrationsobject(request-integrations)


Access Requests integration settings for the org

emailobject(email-settings)

Access Requests email settings for the org

Request Settings for the org for patch example

curl -i -X PATCH \
  https://subdomain-okta.login.adsbillinghub.com/governance/api/v2/request-settings \
  -H 'Content-Type: application/json' \
  -d '{
    "subprocessorsAcknowledged": true
  }'

Responses

A successful org request settings patch 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
subprocessorsAcknowledgedboolean(subprocessors-acknowledged)

Indicates that Access Requests provisioning was triggered by the customer (such as in Govern Okta admin roles)

resourceCatalogVisibilityobject(resource-catalog-visibility)

Visibility settings for access to the resource catalog.

This setting controls the Request Access button visible in the End-User Dashboard. For the Unified requester experience, this setting also controls the Resource Catalog links and search options from the Okta Access Request app, Slack, or Microsoft Teams.

integrationsobject(request-integrations)


Access Requests integration settings for the org

emailobject(email-settings)

Access Requests email settings for the org

Response

Request Settings for the org for patch example

{ "subprocessorsAcknowledged": true }