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

URL

https://api.digitalvault.cloud/subscriptionconnection/{{connection_id}}/permissions/

Method

PUT

URL Path Parameters

Property Description
connection_id Id of the connection to modify permission for

Request Header Parameters

Property Description
Authentication Bearer {access_token}
required		 Retrieve access token

Request Body Params

Name Description
id Id of the connection object
accesscontrolitems Current list of access permissions for connection

Response Body Parameters

Name Description
id Id of the connection object
accesscontrolitems Current list of access permissions for connection

Errors

Error Description
401 Unauthorized
400 Update will leave ACL in invalid state
403 Forbiden. Possible causes:
You do not have access to this endpoint (scope)
 You do not have access to this connection)
504 Timeout while attempting to write connection to storage repository

Example

Request

PUT https://api.digitalvault/subscriptionconnection/fakeconnectionid/permissions/
{
    "id": "TestConnId",
    "accesscontrolitems": {
        "sub:user:bob": "owner",
        "org:jci.com": "readwrite",
        "group:lesserOrg:adminGroup": "admin"
    }
}

Response

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