In addition to the parameters listed in the Request Parameters section, the pin/create method also includes the following parameters:
The event code for the event in which the pin item is being created. 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.
The content of the pin item to be created. May include HTML markup. May not be > 5000 characters in length.
The status of the pin item to be created. Must be set to "published" or "unpublished".
Note: If the maximum number of pin items (3) have already been published, attempting to create new published pin items will return an error.
Where the newly pin item will display. Valid values are "append" or "prepend". Appended items will appear at the end of the list of pin items, while prepended items will appear at the beginning. Omit this parameter if the status request parameter is set to "unpublished". Defaults to "append".
The pin item id of a successfully created pin item is returned in the data field of a general response. This field will consist of a pin_id field, which will contain the pin item id.
Example response to a successful pin/create request:
A variety of error responses (in addition to the common error responses) to pin/create requests, and instructions on how to rectify them:
Required parameter empty: content.
Ensure the content request parameter is present.
Exceeded maximum content length of: 5000
Ensure the content request parameter does not exceed 5000 characters in length (including markup).
Required parameter empty: status.
Ensure the status request parameter is present.
Direction parameter contains an invalid value. Valid values include "append", "prepend".
The direction request parameter can only be populated with one of the following values: "append", "prepend".
The maximum number of pin items have been published.
If the status request parameter is set to "published", and there are already the maximum number of pin items published (3), then new pin items cannot be published. A currently published item must be unpublished first (can be achieved using the pin/update API request).
Direction parameter cannot contain a value when combined with a status parameter with a value of "unpublished".
If the status request parameter is set to "unpublished" the direction request parameter should be omitted.
CoveritLive is the leading live-event publishing platform. Since its release in 2007, CoveritLive has been used by thousands of writers to engage millions of readers around the world. It is actively used both by traditional bloggers, journalists, major brands and mainstream media.