API Discrepancy in Creative Associations POST and PUT - rest/v2/line-items/<line_item_id>/creatives

Incident Report for Beeswax

Monitoring

We are awaiting documentation updates before resolving this incident. There will be no further updates to this matter in the interim.
Posted Jun 12, 2025 - 16:09 EDT

Identified

The API payload for creative line item assignments differs from the documentation for the POST and PUT requests, potentially impacting client integrations.

The discrepancies are as follows:
- The documents indicate that the payload is a single JSON object. This is wrong; the payload should be a JSON array of such objects.
- The "line_item_id" field is indicated as required. It is not, in fact, required.
- The documentation suggests that the creative object is included in the response from the creative associations endpoint, but this does not appear to be accurate.

In addition, the documentation indicated that, on success, a PUT request will return a 200 status. This is incorrect. The status will be 201.

We apologize for any confusion this has caused. We've identified that the API's current behavior is incorrect in our documentation, and we're actively working to get those updates published for you soon.

API REFERENCE: https://api-docs.freewheel.tv/beeswax/v2.0/reference/createcreativelineitemassignment
Posted Jun 04, 2025 - 18:08 EDT
This incident affects: Buzz UI and API.