Overwrite an Existing Access Control List with a New Access Control List

Updates the access control list

URL

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

Method

PUT

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 GUID 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

Request Body Parameters

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

Example

Request

curl -X PUT 
  'https://{{HOST}}/timeseries/permissions/cbd573df-a2ee-4de5-83e1-56127beb4702' 
  -H 'Authorization: Bearer {access_control}' 
  -H 'Cache-Control: no-cache' 
  -H 'Content-Type: application/json' 
  -H 'Postman-Token: 3b2c1b33-8467-40f8-b1be-b9cf2a9e3f66' 
  -d '{
    "objectId": "cbd573df-a2ee-4de5-83e1-56127beb4702",
    "accesscontrolitems": {
        "sub:user:bob": "owner",
        "org:jci.com": "readwrite"
    }
}
'

Response

{
    "objectId": "cbd573df-a2ee-4de5-83e1-56127beb4702",
    "accesscontrolitems": {
        "sub:user:bob": "owner",
        "org:jci.com": "readwrite"
    }
}

Errors

Error Description
Error Name Description of Error

Response Body Parameters

Name Description Schema
objectId Description object definition
accesscontrolitems Description object definition