API Method /events/rights/remove
This function revokes rights to an event from a user's relations (friends/family/contacts). These rights are used to determine access for private events.
Arguments
- authentication
- This method requires user authentication.
- id string
- The event ID.
- relation string
- The relationship type, one of 'friends', 'family', 'contacts'.
Example Request
Here's an example URL:
http://api.evdb.com/rest/events/rights/remove?...&id=E0-001-000001237-8&relation=contacts
Output Parameters
Output from this function is an XML block with the following constructs:
- status string
- ok
- messagestring
- Relationship X removed from event Y.
Example XML Response
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<message>Relationship 'contacts' removed from event 'E0-001-000001237-8'</message>
</response>
Error Codes
This method may return these errors in an error document:
- Authentication error
- The specified user was not found or provided invalid credentials.
- Missing parameter
- The 'id' and 'relation' parameters are mandatory.
- Not found
- There is no event with that identifier.