In this article
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}}’