Link Org to Device

Link a Device to an Org

To link an org to a device, you must be an admin.

URL

https://{{HOST}}/security/device/org?v={version}&deviceId={deviceId}&orgId={organizationId}

Method

POST

Required IMS Scopes

  • securityapi_all

Versions Supported

  • 2.0 (Default)

URL Query Parameters

Name Description Example Type
v
optional		 Version of the api to use /device?v=2.0 number
deviceId
required		 The ID of the device. /device/org?deviceId=testDevice string
orgId
required		 The ID of the org. /device/org?orgId=testorganization string

Request Header Parameters

Type Value Description
Authorization
required		 Bearer {access_token} IMS access token
Content-Type
required		 application/json Content Type

Example

Request

Curl

curl -X POST 
  'https://{{HOST}}/securityapi/device/org?v=2.0&deviceId=testDevice&orgId=testOrganization' 
  -H 'Authorization: Bearer {access_token}' 
  -H 'Content-Type: application/json'

Response

TODO JSON Response

Errors

Error Description
Error Name Description of Error

Response Body Parameters

Name Description Schema
Object Name Description object definition