Delete the Permission, if it exists for the given Principal and the given permission

URL

https://{{HOST}}/subscriptiontopic/{{topic_id}}/permissions/{{principal}}::{{permission}}

Method

DELETE

Required IMS Scopes

  • subscription_write
  • apollo_write

URL Path Parameters

Name Description Example Type
topic_id
required		 Topic ID to revoke permission on d8178fd0-35ed-499e-89ad-d5b13f0d4427 string
principal Principal ID to revoke permission for sub:user:bob string
permission Permission to be revoked admin string

Request Header Parameters

Type Value Description
Authorization
required		 Bearer {access_token} IMS access token
Content-Type
required		 application/json Content Type

Example

Request

curl -X DELETE 
  'https://{{HOST}}/subscriptiontopic/{{topic_id}}/permissions/sub:user:bob::admin' 
  -H 'Authorization: Bearer {access_token}'

Notes

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

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 topic
404 Topic not found for id given
504 Timeout on request to storage repository

Response Body Parameters

Name Description Schema
id Id of the topic object string
accesscontrolitems Current list of access permissions for topic object definition