Skip to content
Start here

Get device posture integration details

client.ZeroTrust.Devices.Posture.Integrations.Get(ctx, integrationID, query) (*Integration, error)
GET/accounts/{account_id}/devices/posture/integration/{integration_id}

Fetches details for a single device posture integration.

Security
API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
ParametersExpand Collapse
integrationID string

API UUID.

maxLength36
query DevicePostureIntegrationGetParams
AccountID param.Field[string]
ReturnsExpand Collapse
type Integration struct{…}
ID stringOptional

API UUID.

maxLength36
Config IntegrationConfigOptional

The configuration object containing third-party integration information.

APIURL string

The Workspace One API URL provided in the Workspace One Admin Dashboard.

AuthURL string

The Workspace One Authorization URL depending on your region.

ClientID string

The Workspace One client ID provided in the Workspace One Admin Dashboard.

Interval stringOptional

The interval between each posture check with the third-party API. Use m for minutes (e.g. 5m) and h for hours (e.g. 12h).

Name stringOptional

The name of the device posture integration.

Type IntegrationTypeOptional

The type of device posture integration.

One of the following:
const IntegrationTypeWorkspaceOne IntegrationType = "workspace_one"
const IntegrationTypeCrowdstrikeS2s IntegrationType = "crowdstrike_s2s"
const IntegrationTypeUptycs IntegrationType = "uptycs"
const IntegrationTypeIntune IntegrationType = "intune"
const IntegrationTypeKolide IntegrationType = "kolide"
const IntegrationTypeTaniumS2s IntegrationType = "tanium_s2s"
const IntegrationTypeSentineloneS2s IntegrationType = "sentinelone_s2s"
const IntegrationTypeCustomS2s IntegrationType = "custom_s2s"

Get device posture integration details

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/option"
  "github.com/stainless-sdks/cloudflare-go/zero_trust"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  integration, err := client.ZeroTrust.Devices.Posture.Integrations.Get(
    context.TODO(),
    "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
    zero_trust.DevicePostureIntegrationGetParams{
      AccountID: cloudflare.F("699d98642c564d2e855e9661899b7252"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", integration.ID)
}
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
    "config": {
      "api_url": "https://as123.awmdm.com/API",
      "auth_url": "https://na.uemauth.workspaceone.com/connect/token",
      "client_id": "example client id"
    },
    "interval": "10m",
    "name": "My Workspace One Integration",
    "type": "workspace_one"
  },
  "success": true
}
Returns Examples
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
    "config": {
      "api_url": "https://as123.awmdm.com/API",
      "auth_url": "https://na.uemauth.workspaceone.com/connect/token",
      "client_id": "example client id"
    },
    "interval": "10m",
    "name": "My Workspace One Integration",
    "type": "workspace_one"
  },
  "success": true
}