Difference between revisions of "API Collections Update"

From unroole CMS wiki
Jump to: navigation, search
(Created page with "== Summary == Allows for updating metadata for a collection. == URI == {{:API_Base_URI}}[channel-id]/sorted_playlists/[playlist-id] == HTTP Method == POST == Required Par...")
 
Line 4: Line 4:
  
 
== URI ==
 
== URI ==
{{:API_Base_URI}}[channel-id]/sorted_playlists/[playlist-id]
+
{{:API_Base_URI}}sorted_playlists/[playlist-id]
  
 
== HTTP Method ==
 
== HTTP Method ==
  
POST
+
PUT
  
 
== Required Paramaters ==
 
== Required Paramaters ==

Revision as of 12:29, 4 June 2012

Summary

Allows for updating metadata for a collection.

URI

https://api.unroole.com/sorted_playlists/[playlist-id]

HTTP Method

PUT

Required Paramaters

Paramater Default Maximum Length Accepted Values Description
token API Persistence Token that identifies this user and its permissions.
unroole_sorted_playlist[name] 255 Name of the collection.

Optional Paramaters

Paramater Default Maximum Length Accepted Values
description MySQL TEXT UTF-8 The description of the collection.
active false boolean Make the playlist active or deactivate (dis-regardless of the active/deactivate date).
activate_at ISO 8061 date This is required if collection is set to active
deactivate_at ISO 8061 date This is required if collection is set to active and does not disable deactivation
disable_deactivation boolean Disable the deactivation date so that the collection will never expire.
playlist false boolean Whether the collection is a slideshow
rotation_speed 0 - 900 The time between the items in the collection playing as a slideshow (in seconds). Only valid when collection is set to a playlist.

Response

Field Type Description
http_status integer API Status Code
http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
error Rails default

Example Response