<%= render 'response' %>

Update a Channel

To update a Channel, send an HTTP PUT to
<%= @ssl_api_domain %>channels/CHANNEL_ID.json.xml .

Valid parameters:

api_key (string) - User's API Key; please note that this is different than a Channel API key, and can be found in your account details. (required).
description (string) - Description of the Channel (optional)
elevation (integer) - Elevation in meters (optional)
field1 (string) - Field1 name (optional)
field2 (string) - Field2 name (optional)
field3 (string) - Field3 name (optional)
field4 (string) - Field4 name (optional)
field5 (string) - Field5 name (optional)
field6 (string) - Field6 name (optional)
field7 (string) - Field7 name (optional)
field8 (string) - Field8 name (optional)
latitude (decimal) - Latitude in degrees (optional)
longitude (decimal) - Longitude in degrees (optional)
metadata (text) - Metadata for the Channel, which can include JSON, XML, or any other data (optional)
name (string) - Name of the Channel (optional)
public_flag (true/false) - Whether the Channel should be public, default false (optional)
tags (string) - Comma-separated list of tags (optional)
url (string) - Webpage URL for the Channel (optional)

Example PUT:

PUT <%= @ssl_api_domain %>channels/4.json.xml
    api_key=<%= @user_api_key %>
    name=Updated Channel

The response will be a webpage with your updated Channel.

The response will be a JSON object of the updated channel, for example:

{
  "id": 4,
  "name": "Updated Channel",
  "description": null,
  "metadata": null,
  "latitude": null,
  "longitude": null,
  "created_at": "2014-03-25T13:12:50-04:00",
  "elevation": null,
  "last_entry_id": null,
  "ranking": 15,
  "username": "hans",
  "tags": [],
  "api_keys":
  [
    {
      "api_key": "XXXXXXXXXXXXXXXX",
      "write_flag": true
    }
  ]
}

The response will be an XML object of the updated channel, for example:

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">4</id>
    <name>Updated Channel</name>
    <description nil="true" />
    <metadata nil="true" />
    <latitude type="decimal" nil="true" />
    <longitude type="decimal" nil="true" />
    <created-at type="dateTime">2014-03-25T20:17:44-04:00</created-at>
    <elevation nil="true" />
    <last-entry-id type="integer" nil="true" />
    <ranking type="integer">15</ranking>
    <username>hans</username>
    <tags type="array" />
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
    </api-keys>
</channel>