Post access control list

Use this endpoint to create a new ACL for a device

URL

https://{{HOST}}/security/device/{deviceId}/permissions

Method

POST

Required IMS Scopes

  • securityapi_all

URL Path Parameters

Name Description Type
device
required		 Device ID for access control list string

Request Header Parameters

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

Request Body Parameters

Name Description Type
Object Name
required		 Description object definition
objectId
required		 Description object definition
accesscontrolitems
required		 Description object definition

Example

Request

TODO

Response

{
    "objectId": "TestDeviceId",
    "accesscontrolitems": {
        "sub:user:bob": "owner",
        "org:jci.com": "readwrite",
        "group:lesserOrg:adminGroup": "admin",
        "principal": "permission"
    }
}

Errors

Error Description
Error Name Description of Error

Response Body Parameters

Name Description Schema
Object Name Description object definition
objectId Description object definition
accesscontrolitems Description object definition