API Method /events/rights/add
This function gives a user's relations (friends/family/contacts) rights to an event. These rights are used to determine access for private events. (To add a user as the authenticated user's relation, use the /users/relations/add method.)
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/add?...&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 added to event Y.
Example XML Response
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<message>Relationship 'contacts' added to 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.