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.
 

This website uses cookies to ensure that you receive the best experience. By clicking "Accept" or closing this window, you are agreeing to our cookies policy. You can change your cookie settings at any time and read about how we use them in our Cookie Policy