Device Integrations

The Device Integrations API provides operations to retrieve, and activate or deactivate, an endpoint security integration in your organization. Examples of device integrations include the following:

  • Device Posture Provider
  • Windows Security Center
  • Chrome Device Trust
  • OSQuery
  • Android Device Trust

List all device integrations
Early Access
OAuth 2.0 scopes:
  • okta.deviceIntegrations.read

Lists all device integrations for your org. Examples include Device Posture Provider, Windows Security Center, Chrome Device Trust, OSQuery, and Android Device Trust.

Responses
200

OK

401

Unauthorized

403

Forbidden

429

Too Many Requests

get/api/v1/device-integrations
Request samples 
Response samples 
application/json
[
  • {
    • "displayName": "string",
    • "id": "string",
    • "metadata": {
      },
    • "name": "com.android.zero.trust",
    • "platform": "ANDROID",
    • "status": "ACTIVE",
    • "_links": {
      }
    }
]
Retrieve a device integration
Early Access
OAuth 2.0 scopes: 
  • okta.deviceIntegrations.read
Retrieves a device integration by deviceIntegrationId


Request 
path Parameters
deviceIntegrationId
required
string
The ID of the device integration


 
Responses 
200
OK


401
Unauthorized


403
Forbidden


429
Too Many Requests


get/api/v1/device-integrations/{deviceIntegrationId}
Request samples 
Response samples 
application/json
{}
Activate a device integration
Early Access
OAuth 2.0 scopes: 
  • okta.deviceIntegrations.manage
Activates a device integration and populates the related configurations by deviceIntegrationId


Request 
path Parameters
deviceIntegrationId
required
string
The ID of the device integration


 
Responses 
200
OK


401
Unauthorized


403
Forbidden


404
Not Found


429
Too Many Requests


post/api/v1/device-integrations/{deviceIntegrationId}/lifecycle/activate
Request samples 
Response samples 
application/json
{}
Deactivate a device integration
Early Access
OAuth 2.0 scopes: 
  • okta.deviceIntegrations.manage
Deactivates a device integration by deviceIntegrationId


Request 
path Parameters
deviceIntegrationId
required
string
The ID of the device integration


 
Responses 
200
OK


401
Unauthorized


403
Forbidden


404
Not Found


429
Too Many Requests


post/api/v1/device-integrations/{deviceIntegrationId}/lifecycle/deactivate
Request samples 
Response samples 
application/json
{}