Delete Any Permissions for a Pricipal

Delete any permissions which may exist for the given principal on the given timeseries

URL

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

Method

DELETE

Required ACL Permissions

  • owner
  • admin

Versions Supported

  • 2.0 (Default)
  • 2.1

URL Path Parameters

Name Description Example Type
id
optional		 Id of Needed for the Endpoint /endpoint/id string
timeseries_id
required		 Timeseries ID on which to revoke permissions GUID string
principal
required		 Principal ID for which to revoke all permissions sub:user:{username} 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 DELETE 
  'https://{{HOST}}/timeseries/timeseries/cbd573df-a2ee-4de5-83e1-56127beb4702/permissions/sub:user:bob' 
  -H 'Authorization: Bearer {access_token}' 
  -H 'Cache-Control: no-cache' 
  -H 'Content-Type: application/json'

Response

{
    "objectId": "cbd573df-a2ee-4de5-83e1-56127beb4702",
    "accesscontrolitems": {
        "sub:user:exampleuser": "owner"
    }
}

Errors

Error Description
Error Name Description of Error
403 Forbidden