Get Access Control List

Retrives the timeseries access control list

URL

https://{{HOST}}/timeseries/timeseries/{timeseries_id}/permissions

Method

GET

Required IMS Scopes

  • Read
  • Write

Required ACL Permissions

  • owner
  • admin

Versions Supported

  • 2.0 (Default)
  • 2.1

URL Path Parameters

Name Description Example Type
timeseries_id
required		 Timeseries ID for access control list string

URL Query Parameters

Name Description Example Type
v
optional		 Version of the API to use v=2.0 string

Request Header Parameters

Type Value Description
Authentication Bearer {access_token}
required		 Retrieve access token
Content-Type application/json
required		 Description

Example

Request

curl -X GET 
  'https://{{HOST}}/timeseries/timeseries/cbd573df-a2ee-4de5-83e1-56127beb4702/permissions' 
  -H 'Authorization: Bearer {access_token}' 
  -H 'Cache-Control: no-cache' 
  -H 'Content-Type: application/json'

Response

{
    "objectId": "TestTimesriesId",
    "accesscontrolitems": {
        "sub:user:bob": "owner",
        "org:jci.com": "readwrite"
    }
}

Errors

Error Description
Error Name Description of Error
403 Forbidden

Response Body Parameters

Name Description Schema
objectId Description object definition
accesscontrolitems Description object definition