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.
event.edit [HTTP POST]
Edit an event in the database. Missing parameters will clear out their corresponding values in the event. You must authenticate as the user who added the event to do this. This method requires authentication.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

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

event_id (Required)
The id of the event to edit.

name (Required)
The name of the event.

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

category_id (Numeric, Required)
The category_id of the event. To get a category_id, try the category.* series of functions.

start_date (YYYY-MM-DD, Required)
The start date of the event, formatted as YYYY-MM-DD.

end_date (YYYY-MM-DD, Optional)
The end date of the event, formatted as YYYY-MM-DD.

start_time (HH:MM:SS, Optional)
The start time of the event, formatted as HH:MM:SS.

end_time (HH:MM:SS, Optional)
The end time of the event, formatted as HH:MM:SS.

description (Optional)
A textual description of the event.

url (Optional)
The website URL for the event.

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

selfpromotion (1 or 0, Optional, Defaults to 0)
A flag indicating whether the event should be marked as a normal event (0), or as a self-promotional event (1).

Example Response (returns the details for the event you edited)
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
  <event id="1" name="Tori Amos, Ben Folds" 
    description="The &quot;Lottapianos&quot; Tour.  Ben Folds is opening, and will 
    play a one hour set." 
    start_date="2003-08-01" 
    end_date="0000-00-00" 
    start_time="19:00:00" end_time="" 
    personal="0" selfpromotion="0" 
    metro_id="1" venue_id="1" 
    user_id="1" category_id="1" 
    date_posted="2003-06-07" />
</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.
  • Missing event_id parameter.
  • Missing name parameter.
  • Missing start_date 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 category_id parameter - category_id must be numeric and refer to a valid category.
  • Invalid venue_id parameter - venue_id must be numeric and refer to a valid venue.
  • Invalid start_date parameter - start_date must be formatted as YYYY-MM-DD.
  • Invalid end_date parameter - end_date must be formatted as YYYY-MM-DD.
  • Event could not be loaded, or you do not have access to it.
  • You are not the owner of this event, and may not edit it.
  • Invalid start_time parameter. Valid format is HH:MM:SS.
  • Invalid end_time parameter. Valid format is HH:MM:SS.
  • End_date cannot be before start_date.
Tools
Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help
News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board