Method: /venue_update

Update an existing venue.

Invocation

Request Parameters

Parameter Description Type Extra
key Zvents Developer API key String required
id The ID of the venue to update. Integer required
name The name of the venue. String optional
description A description of the venue. String optional
url The external URL of the venue. String optional
phone The phone number of the venue String optional
address The address of the venue String optional
city The city of the venue String optional
state The state of the venue String optional
country The country of the venue String optional
zipcode The zipcode of the venue String optional
timezone The timezone of the venue String optional
latitude The latitude of the venue Float optional
longitude The longitude of the venue Float optional

Example Request

Response Parameters

The response lists attributes of the updated venue.

Parameter Description Type Mandatory
id The unique ID for the venue. Integer Y
name The name of the venue. String Y
description A description of the venue. String
creator_id The ID of the user that created the venue. Integer Y
link The URL of the venue page on zvents.com String Y
url The external URL of the venue. String
phone The phone number of the venue String
address The address of the venue String Y
city The city of the venue String Y
state The state of the venue String Y
country The country of the venue String Y
zipcode The zipcode of the venue String
timezone The timezone of the venue String Y
latitude The latitude of the venue Float Y
longitude The longitude of the venue Float Y
hours Hours of operation for the venue. String N
tags A list of tags associated with this venue. String List
venue types A list of types for this venue. String List
images If this venue has images, this field provides a list of URLs for those images. String List

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<rsp status="ok">
  <stream_count>1</stream_count>
  <venue id="4506">
    <name>Tech Museum of Innovation</name>
    <description>
      The Tech is a cosmopolitan museum singularly focused on technology,
      how it works and the way that it is changing every aspect of
      the way we work, live, play and learn. Its people-and-technology
      focus and the integration of advanced technologies into visitor
      experiences and infrastructure, distinguishes it from other science
      centers. The 132,000 square feet of The Tech are shared by four
      major theme galleries packed full of one-of-a-kind exhibits, the
      Hackworth IMAX Dome Theater, an educational center for workshops and
      labs, an upscale cafe, and a retail store featuring books, gifts,
      and only-in-Silicon Valley items. An estimated 650,000 visitors are
      expected to trek to The Tech each year, making it one of California's
      most popular destinations. The Tech began as a dream. In 1978,
      members of the Junior League of Palo Alto, later joined by the
      San Jose League, envisioned an exciting learning center devoted to
      science and technology in the heart of Silicon Valley. The vision
      for The Tech was realized in 1990 when a 20,000-square-foot temporary
      test facility was opened in the old convention center on San Carlos
      Street. Since then, The Tech has fine-tuned its mission of engaging
      people of all ages in the technologies that affect their daily lives
      and has built a reputation as a viable and necessary educational
      resource in the area of science and technology learning. It has
      also become a landmark for visitors seeking a glimpse of the most
      inventive place on Earth and a showcase of the latest high-tech gizmos
      and gadgets that put Silicon Valley on the map. Since the prototype
      Tech opened, approximately 2,800,000 visitors from all over the world
      have enjoyed a one-of-a-kind, up close view of Silicon Valley with
      hands-on, interactive exhibits, workshops, labs, a speakers series,
      an online exhibit hall and other activities, such as the annual Tech
      Challenge. This high-tech design contest has attracted nearly 8,000
      youth during the eleven years of the competition. Gallery Hours:
      Tues-Sun: 10am-5pm Open Holiday Mondays. *See website for IMAX
      showtimes and ticket prices. We are open the following Holidays:
      Monday, February 21st Presidents' Day Monday, May 30th Memorial Day
      Monday, July 4th Independence Day Monday, September 5th Labor Day
      Monday, October 10th Columbus Day Friday, November 11th Veteran's
      Day Monday, December 19th, 2005 Christmas Holiday Monday, December
      26th, 2005 Christmas Holiday Monday, January 2th, 2006 New Years Day
      (Observed)
    </description>
    <phone>(408) 294-8324</phone>
    <link>http://www.zvents.com/venues/show/4506</link>
    <url>http://www.thetech.org</url>
    <creator_id>2</creator_id>
    <address>201 S. Market St.</address>
    <city>San Jose</city>
    <zipcode>95113</zipcode>
    <state>California</state>
    <country>United States</country>
    <timezone>US/Pacific</timezone>
    <latitude>37.3319</latitude>
    <longitude>-121.89</longitude>
    <venue_types>
      <venue_type>
        <id>11</id>
        <name>Museum / Planetarium</name>
      </venue_type>
    </venue_types>
    <images>
     <url>http://www.zvents.com/images/internal/img_885.jpg</url>
    </images>
  </venue>
</rsp>

Output Fields

Note: The REST API does not return all possible fields for each item by default. Since some response fields are not used by most API users, these fields are suppressed from the response by default in order to reduce latency for the common calls. Additional fields can be enabled in the response using the fields parameters documented in the 'Optimizing API calls for performance' section.

Output Formats

REST responses can be returned in a number of different formats include XML, JSON and CSV. Read the documentation on output formats.

Possible Errors

This method may return one of the following errors.

Read the documentation on error formats.