This method allows an admin user to modify any venue that has status 'pending' or 'active'. This modification is performed by submitting the venue_id plus one or more additional fields that need to be changed. Generally this will be performed after using list_pending and get_pending to review modifications that have been submitted.
The submitting user will get an email notification unless they have disabled notifications in their preferences.
If venue_name, latitude and/or longitude are given then the new venue_name/latitude/longitude combination that would be created must not match another existing venue.
When a venue is modified with this method, that venue is updated in the database such that it will no longer show up as having pending updates (until such time as new updates are added with update).
This method does not currently check to see that the new data you are submitting is actually any different to the existing data. It assumes all new data is valid even if it is not actually new.
This method does not currently verify that the data has gone into the database. If needed, you can verify the update yourself by using get or get_pending as appropriate.
At the present time, only 'gb' is accepted as a valid country.
| Required Arguments | |
|---|---|
| user_email | For authentication |
| user_password | For authentication |
| venue_id | Venue ID code |
| Optional Arguments (one or more must be provided) | |
|---|---|
| venue_name | Name of venue |
| alt_names | Alternative names for venue |
| previous_names | Previous names for venue |
| address1 | First line of address |
| address2 | Second line of address |
| town | Town |
| region | County, state or region |
| country_code | Country in ISO 3166-1 Alpha-2 format |
| postal_code | Postcode |
| latitude | Latitude |
| longitude | Longitude |
http://api.ives.info/rest/venues/modify?user_email=user@domain.com&user_password=fak3passw0rd &venue_id=http://ives.info/gb/4d5rr&venue_name=The%20Electric%20Ballroom&address1=
Errors will be returned in the form of an error document.
Sample XML Output<?xml version="1.0" encoding="UTF-8"?> <response status="ok"> <message>Venue 'http://ives.info/gb/4d5rr' modified</message> </response>