Skip to content
Okta Identity Governance
/
Management APIs
/
/Request Conditions

Request Conditions

Request conditions define what resources and access levels requesters can request from their resource catalog.

Each request condition defines the following:

  • Who can request access
  • What resource and access level they can request
  • How long the access should be granted for
  • What request sequence to use for approval
  • A priority to control what condition should take precedence when a requester matches against multiple request conditions

See Access request conditions for more information on Access request conditions and Identity Governance.

Note: The following are maximum access-level limits for a request condition:

  • The maximum requestable entitlement bundles for a condition is 1000.
  • The maximum requestable unique groups for a condition is 1000.
Operations

List all resource request conditions

Request

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

Lists request conditions for a resource specified by resourceId

Path
resourceIdstringrequired

Unique identifier for the resource in Okta instance ID format or ORN format

curl -i -X GET \
  'https://subdomain.okta.com/governance/api/v2/resources/{resourceId}/request-conditions'

Responses

A successful request condition list 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
dataArray of objects(request-condition-sparse)required

All request conditions

Response

Basic request conditions that are returned from a get call

{
  "data": [
    { … },
    { … },
    { … }
  ],
  "_links": {
    "self": { … }
  }
}