Method: /event_add_tag
Add a tag to an event.
Invocation
- This method must be invoked using HTTP POST.
- This method requires an API key
Request Parameters
| Parameter | Description | Type | Extra |
| key | Zvents Developer API key | String | required |
| id | ID of the event to which the tag will be added | Integer | required |
| tag | The name of the tag to add to the event | String | required |
Example Request
- http://www.zvents.com/rest/event_add_tag?id=154927&tag=jazz&key=YOUR_API_KEY
Response Parameters
The response contains the list of tags on the event (after the current tag is added).
| Parameter | Description | Type |
| id | The unique ID for the tag. | Integer |
| name | The name of the tag. | String |
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.
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<rsp status="ok">
<stream_count>1</stream_count>
<tag id="8">
<name>jazz</name>
</tag>
</rsp>
Possible Errors
This method may return one of the following errors.
- Unknown Event ID: The event ID requested does not exist.
- Insufficient Permissions: You are not allowed to add tags to the event.
- Invalid API Key: The API key supplied is not valid.
- Call Limit Exceeded: The API key has exceeded the daily maximum number of calls.