Description

Unsubscribe from a specific Event Type. The Event Type is designated by including the domain-entity-event type combination that is to be deleted. Please note that all filter combinations for that Event Type are also deleted.

 
URL Structure
{Base URL}/subscriptions/{domain}/{entity}/{event_type}
HTTP Method DELETE  
Authentication Required  
Request Headers none
Parameters none  
Request Body none  
Returns none  

Errors

Return Code Additional Explanation
403 Only Event Hub Administrators may delete a Subscription for another Entity.
404 Subscription was never defined.
<fault_message xmlns="http://ws.byu.edu/namespace/event-hub/v1">
  <return_code/>   -- http return code
  <explanation/>   -- see the table above
  <error_data/>    -- from request
</fault_message>
<fault_message xmlns="http://ws.byu.edu/namespace/event-hub/v1">
   <return_code>404</return_code>
   <explanation>
      Subscription was never defined
   </explanation>
   <error_data>585241162</error_data>
</fault_message>
{
  "fault_message": {
    "return_code": "404",
    "explanation": 
      "Subscription was never defined",
    "error_data": "585241162"
  }
}
Notes

This service may be invoked by an Event Hub administrator in behalf of an Event Consuming Application.

The URL Structure is modified in the following fashion:

{Base URL}/subscriptions/{identity_id}/{domain}/{entity}/{event_type}

The identity_id is currently defined as the person_id associated with the Event Consuming Application.