Delete Any Permissions which may exist for the given principal on the given subscription connection

URL

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

Method

DELETE

Required IMS Scopes

subscription_write

URL Path Parameters

Name Description
connection_id Connection ID to revoke permission on
principal Principal ID to revoke permission for

Request Header Parameters

Property Description
Authentication Bearer {access_token}
required
Retrieve access token

Response Body Parameters

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

Errors

Error Description
400 Invalid delete, occurs when action would leave ACL in invalid state, ie, delete owner
401 Unauthorized
403 Forbiden. Possible causes:
You do not have access to this endpoint (scope)
You do not have access to this connection
404 Connection not found for id given
504 Timeout on request to storage repository

Example

Request

DELETE https://api.digitalvault.cloud/subscriptionconnection/fakeconnectionid/permissions/fakeprincipal

Notes

  • Use the following formats to define the subscriber:
    • User = ‘sub:user:{{USERID}}’
    • Application: ‘sub:app:{{APPID}}’