Update campaigns, line items, and creatives
Overview
This article describes the available endpoints for updating campaigns, line items, and creatives. It also outlines which campaign attributes can and cannot be modified after creation, the rules for updating products, and the impact of changes that trigger campaign revalidation.
Main endpoints
| Method | Endpoint | Description | Link |
|---|---|---|---|
| PATCH | https://api.kaminoretail.dev/v2/campaigns/{campaign_id} |
Update the status of a campaign. | Patch a campaign |
| PUT | https://api.kaminoretail.dev/v2/campaigns/{campaign_id} |
Update details of a specific campaign. |
|
| PUT | https://api.kaminoretail.dev/v2/line-items/{line_item_id} |
Update details of a specific line item. |
|
| PUT | https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives/batch |
Update a batch of creatives. | Update a batch of creatives |
| PUT | https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives/{creative_id} |
Update a specific creative. |
|
Update rules
After you create a campaign, you can only edit certain elements to improve the performance of the campaign:
- Attribution window
- Budget (only if the new budget is higher than the budget that you already spent)
- Buyer
- Insertion order
- Name
- Pacing
- Products listing
- Start date and end date
For products, you can perform the following actions:
- Add new products. ⚠️Warning: you can’t delete products.
- Change bids.
- Enable or disable products.
You can’t edit the following elements:
- Brand
- Website.
If you modify the budget, keywords, promoted products, or any other validation-sensitive attribute, the campaign status automatically changes to Paused. Kamino then initiates a new retailer validation process. For more information about the validation workflow, see Approve campaigns.
A disabled product won’t display on the retailer website, but the product is still included in the attribution sales.