COVERITLIVE API - REPLY/UPDATE (V. 2.0)

The Request

This method allows the content of a reply to be updated. Any updates made will immediately propagate to all readers of the live event in real time. Reply items are identified by a reply id, which is returned by the reply/create and event/data API methods.

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

Parameter Description Required
event_code The event code for the event in which the reply 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
reply_id The id of the reply item to be updated. These ids are returned by the reply/create and event/data API methods. yes
comment This is the content which will replace the current item content. May include HTML markup. May not be > 5000 characters in length. no

The Response

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

Example response to a successful reply/update request:


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

reply/update Error Responses

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

result response message response solution
missing_comment_param Required parameter empty: comment. Ensure the comment request parameter is present when making a reply/update request.
invalid_comment_param Exceeded maximum comment length of: 5000 Ensure the comment request parameter is does not exceed 5000 characters in length (including markup).
missing_reply_id_param Required parameter empty: reply_id Ensure the reply_id request parameter is present when making a reply/update request.
invalid_reply_id_param The reply_id request parameter did not contain a valid reply item id. When populating the reply_id request parameter, ensure it contains a valid reply_id.