Welcome, Guest Sign In | Sign Up | Help
Upcoming API Documentation
Currently, the use of these APIs are restricted to non-commercial use only. If you'd like to use it for commercial purposes, please contact us first.
venue.edit [HTTP POST]
Edit a venue. Only the authenticated user that added the venue may edit it. You must pass authentication parameters for this function.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

token (Required)
An authentication token. (What's this?)

venue_id (Numeric, Required)
The id of the venue.

venuename (Required)
The name of the venue.

venueaddress (Required)
The name of the venue.

venuecity (Required)
The name of the venue.

metro_id (Numeric, Required)
The metro_id of the venue. To get a metro_id, try the metro.* series of functions.

venuezip (Optional)
The venue's Zip Code or equivalent.

venuephone (Optional)
The venue's phone number.

venueurl (Optional)
The url of the venue's website (if any).

venuedescription (Optional)
A textual description of the venue.

private (1 or 0, Optional, Defaults to 0)
A flag indicating whether the venue should be public (0), or shown only to your friends (1).

Example Response (returns the details for the venue you edited)
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
	<venue id="6087" name="Test REST Venue.add" address="123 Privacy Ln" 
		city="Los Angeles" zip="" phone="" url="" description="" 
		user_id="10708" private="0" />
</rsp>		
Error Codes (sent in HTTP Response Header)
403 Not Authorized:
  • Missing valid authentication parameters - Please pass an authentication token to the method.
  • Invalid authentication parameters - either that token was not found, or it may be deactivated. Please contact us for support.

409 Conflict:
  • Missing valid api_key - Please create an API key using the above link.
  • Your api_key is inactive or not found - Please contact us for support.
  • Invalid venue_id parameter - venue_id must be numeric and refer to a valid venue.
  • Missing venuename parameter.
  • Missing venueaddress parameter.
  • Missing venuecity parameter.
  • Invalid metro_id parameter - metro_id must be numeric and refer to a valid metro.
  • Invalid user_id parameter - Internal error, please contact us for support.
  • Invalid private parameter - private must be either 1 or 0.
  • That venue_id does not exist or might be private.
  • An unknown error occurred.
  • You may not edit that venue because you are not its owner.
Tools
Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help
News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board