COVERITLIVE API - CONTENT/UPDATE (V. 2.0)

The Request

This method allows you to update any item in a live event. Similar to the Live Edit functionality available through the console, any update made will immediately propagate to all readers of the live event in real time. Items in the event are identified by item ids, which are returned by the content/create and event/data API methods.

URL:
https://api.coveritlive.com/remote/2/content/update
Response Formats:
JSON
HTTP Method(s):
POST
API Rate Limited:
false
In addition to the parameters listed in the Request Parameters section, the content/update method also includes the following parameters:

Parameter Description Required
event_code The event code for the event in which the item to be updated exists. Each CiL event that is created is assigned a unique event code that identifies it in the database - The event owner can find this value after creating a new event, by selecting the "altcast_code" which is found in their Viewer Window embed code (e.g. the event code is "46e6cd22b5" in "altcast_code=46e6cd22b5"). This value is also returned by the event/list API method. yes
content This is the content which will replace the current item content. May include HTML markup. May not be > 500 characters in length. yes
item_id The id of the event item to be updated. These ids are returned by the content/create and event/data API methods. no

The Response

There is no extra data returned from an content/update request, so the response has the same fields as a general response.

Example response to a successful content/update request:


{
	"result": "success",
	"message": "true",
	"type": "content",
	"action": "update",
	"version": 2
}

content/update Error Responses

A variety of error responses (in addition to the common error responses) to content/update requests, and instructions on how to rectify them:

result response message response solution
missing_content_param Required parameter empty: content Ensure the content request parameter is present when making a content/update request.
invalid_content_param Exceeded maximum content length of: 500 Ensure the content request parameter is does not exceed 500 characters in length (including markup).
missing_item_id_param Required parameter empty: item_id Ensure the item_id request parameter is present when making a content/update request.
invalid_item_id The item_id request parameter did not contain a valid item id. When populating the item_id request parameter, ensure it contains a valid item_id.
invalid_content_type The following types of content cannot be edited: Instagram, Wikipedia, Rss, Facebook, Tweet Only certain types of content can be updated. The following types cannot be edited: Instagram (instagram), Wikipedia (wikipeida), RSS (rss), Facebook (facebook) and Tweet (appears as guest_comment).