Device Access

The Device Access API provides operations to configure device access settings.

Retrieve the Desktop MFA Enforce Number Matching Challenge org setting
Identity Engine
OAuth 2.0:
  • okta.orgs.read

Retrieves the status of the Desktop MFA Enforce Number Matching Challenge push notifications feature. That is, whether or not the feature is enabled for your org.

Responses
200

OK

403

Forbidden

429

Too Many Requests

get/device-access/api/v1/desktop-mfa/enforce-number-matching-challenge-settings
Request samples 
Response samples 
application/json
{
  • "desktopMFAEnforceNumberMatchingChallengeEnabled": false
}
Replace the Desktop MFA Enforce Number Matching Challenge org setting
Identity Engine
OAuth 2.0: 
  • okta.orgs.manage
Replaces the status of the Desktop MFA Enforce Number Matching Challenge push notifications feature. That is, whether or not the feature is enabled for your org.


Request 
Request Body schema: application/json
required
desktopMFAEnforceNumberMatchingChallengeEnabled
boolean
 Default:  false
Indicates whether or not the Desktop MFA Enforce Number Matching Challenge push notifications feature is enabled


 
Responses 
200
OK


400
Bad Request


403
Forbidden


429
Too Many Requests


put/device-access/api/v1/desktop-mfa/enforce-number-matching-challenge-settings
Request samples 
application/json
{
  • "desktopMFAEnforceNumberMatchingChallengeEnabled": false
}
Response samples 
application/json
{
  • "desktopMFAEnforceNumberMatchingChallengeEnabled": false
}
Retrieve the Desktop MFA Recovery PIN org setting
Identity Engine
OAuth 2.0: 
  • okta.orgs.read
Retrieves the status of the Desktop MFA Recovery PIN feature. That is, whether or not the feature is enabled for your org.


Responses 
200
OK


403
Forbidden


429
Too Many Requests


get/device-access/api/v1/desktop-mfa/recovery-pin-settings
Request samples 
Response samples 
application/json
{
  • "desktopMFARecoveryPinEnabled": false
}
Replace the Desktop MFA Recovery PIN org setting
Identity Engine
OAuth 2.0: 
  • okta.orgs.manage
Replaces the Desktop MFA Recovery PIN feature for your org


Request 
Request Body schema: application/json
required
desktopMFARecoveryPinEnabled
boolean
 Default:  false
Indicates whether or not the Desktop MFA Recovery PIN feature is enabled


 
Responses 
200
OK


400
Bad Request


403
Forbidden


429
Too Many Requests


put/device-access/api/v1/desktop-mfa/recovery-pin-settings
Request samples 
application/json
{
  • "desktopMFARecoveryPinEnabled": false
}
Response samples 
application/json
{
  • "desktopMFARecoveryPinEnabled": false
}