Okta.Sdk.Api.DeviceIntegrationsApi

October 22, 2025 · View on GitHub

All URIs are relative to https://subdomain.okta.com

Method	HTTP request	Description
ActivateDeviceIntegration	POST /api/v1/device-integrations/{deviceIntegrationId}/lifecycle/activate	Activate a device integration
DeactivateDeviceIntegration	POST /api/v1/device-integrations/{deviceIntegrationId}/lifecycle/deactivate	Deactivate a device integration
GetDeviceIntegration	GET /api/v1/device-integrations/{deviceIntegrationId}	Retrieve a device integration
ListDeviceIntegrations	GET /api/v1/device-integrations	List all device integrations

ActivateDeviceIntegration

DeviceIntegrations ActivateDeviceIntegration (string deviceIntegrationId)

Activate a device integration

Activates a device integration and populates the related configurations by deviceIntegrationId

Example

using System.Collections.Generic;
using System.Diagnostics;
using Okta.Sdk.Api;
using Okta.Sdk.Client;
using Okta.Sdk.Model;

namespace Example
{
    public class ActivateDeviceIntegrationExample
    {
        public static void Main()
        {
            Configuration config = new Configuration();
            config.OktaDomain = "https://subdomain.okta.com";
            // Configure API key authorization: apiToken
            config.Token ="YOUR_API_KEY";
            // Configure OAuth2 access token for authorization: oauth2
            config.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new DeviceIntegrationsApi(config);
            var deviceIntegrationId = "deviceIntegrationId_example";  // string | The ID of the device integration

            try
            {
                // Activate a device integration
                DeviceIntegrations result = apiInstance.ActivateDeviceIntegration(deviceIntegrationId);
                Debug.WriteLine(result);
            }
            catch (ApiException  e)
            {
                Debug.Print("Exception when calling DeviceIntegrationsApi.ActivateDeviceIntegration: " + e.Message );
                Debug.Print("Status Code: "+ e.ErrorCode);
                Debug.Print(e.StackTrace);
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
deviceIntegrationId	string	The ID of the device integration

Return type

DeviceIntegrations

Authorization

apiToken, oauth2

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	OK	-
401	Unauthorized	-
403	Forbidden	-
404	Not Found	-
429	Too Many Requests	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeactivateDeviceIntegration

DeviceIntegrations DeactivateDeviceIntegration (string deviceIntegrationId)

Deactivate a device integration

Deactivates a device integration by deviceIntegrationId

Example

using System.Collections.Generic;
using System.Diagnostics;
using Okta.Sdk.Api;
using Okta.Sdk.Client;
using Okta.Sdk.Model;

namespace Example
{
    public class DeactivateDeviceIntegrationExample
    {
        public static void Main()
        {
            Configuration config = new Configuration();
            config.OktaDomain = "https://subdomain.okta.com";
            // Configure API key authorization: apiToken
            config.Token ="YOUR_API_KEY";
            // Configure OAuth2 access token for authorization: oauth2
            config.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new DeviceIntegrationsApi(config);
            var deviceIntegrationId = "deviceIntegrationId_example";  // string | The ID of the device integration

            try
            {
                // Deactivate a device integration
                DeviceIntegrations result = apiInstance.DeactivateDeviceIntegration(deviceIntegrationId);
                Debug.WriteLine(result);
            }
            catch (ApiException  e)
            {
                Debug.Print("Exception when calling DeviceIntegrationsApi.DeactivateDeviceIntegration: " + e.Message );
                Debug.Print("Status Code: "+ e.ErrorCode);
                Debug.Print(e.StackTrace);
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
deviceIntegrationId	string	The ID of the device integration

Return type

DeviceIntegrations

Authorization

apiToken, oauth2

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	OK	-
401	Unauthorized	-
403	Forbidden	-
404	Not Found	-
429	Too Many Requests	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetDeviceIntegration

DeviceIntegrations GetDeviceIntegration (string deviceIntegrationId)

Retrieve a device integration

Retrieves a device integration by deviceIntegrationId

Example

using System.Collections.Generic;
using System.Diagnostics;
using Okta.Sdk.Api;
using Okta.Sdk.Client;
using Okta.Sdk.Model;

namespace Example
{
    public class GetDeviceIntegrationExample
    {
        public static void Main()
        {
            Configuration config = new Configuration();
            config.OktaDomain = "https://subdomain.okta.com";
            // Configure API key authorization: apiToken
            config.Token ="YOUR_API_KEY";
            // Configure OAuth2 access token for authorization: oauth2
            config.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new DeviceIntegrationsApi(config);
            var deviceIntegrationId = "deviceIntegrationId_example";  // string | The ID of the device integration

            try
            {
                // Retrieve a device integration
                DeviceIntegrations result = apiInstance.GetDeviceIntegration(deviceIntegrationId);
                Debug.WriteLine(result);
            }
            catch (ApiException  e)
            {
                Debug.Print("Exception when calling DeviceIntegrationsApi.GetDeviceIntegration: " + e.Message );
                Debug.Print("Status Code: "+ e.ErrorCode);
                Debug.Print(e.StackTrace);
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
deviceIntegrationId	string	The ID of the device integration

Return type

DeviceIntegrations

Authorization

apiToken, oauth2

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	OK	-
401	Unauthorized	-
403	Forbidden	-
429	Too Many Requests	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListDeviceIntegrations

List<DeviceIntegrations> ListDeviceIntegrations ()

List all device integrations

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

Example

using System.Collections.Generic;
using System.Diagnostics;
using Okta.Sdk.Api;
using Okta.Sdk.Client;
using Okta.Sdk.Model;

namespace Example
{
    public class ListDeviceIntegrationsExample
    {
        public static void Main()
        {
            Configuration config = new Configuration();
            config.OktaDomain = "https://subdomain.okta.com";
            // Configure API key authorization: apiToken
            config.Token ="YOUR_API_KEY";
            // Configure OAuth2 access token for authorization: oauth2
            config.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new DeviceIntegrationsApi(config);

            try
            {
                // List all device integrations
                List<DeviceIntegrations> result = apiInstance.ListDeviceIntegrations().ToListAsync();
                Debug.WriteLine(result);
            }
            catch (ApiException  e)
            {
                Debug.Print("Exception when calling DeviceIntegrationsApi.ListDeviceIntegrations: " + e.Message );
                Debug.Print("Status Code: "+ e.ErrorCode);
                Debug.Print(e.StackTrace);
            }
        }
    }
}

Parameters

This endpoint does not need any parameter.

Return type

List<DeviceIntegrations>

Authorization

apiToken, oauth2

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	OK	-
401	Unauthorized	-
403	Forbidden	-
429	Too Many Requests	-

[Back to top] [Back to API list] [Back to Model list] [Back to README]