Curator API: Update an Ad
PUT https://api.curator.io/v1.3/ads/AD_ID replaces an ad's details. PATCH and POST to the same URL do the same thing. The request needs your API key, and your plan must include API access. Only HTTPS is supported.
Authentication
Send your Curator API key (find it in the Curator Dashboard) in one of three ways: as a query string (?api_key=API_KEY), as a Basic auth header with the API key as the username, or as a Bearer token (Authorization: Bearer API_KEY, with Bearer capitalised). You can only update ads in the account the key belongs to.
Example request
curl -X PUT "https://api.curator.io/v1.3/ads/AD_ID" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{"feed_id": "FEED_ID", "name": "Summer sale", "text": "30% off this week", "status": "active", "click_action": "nothing", "position_start": 3, "position_repeats": false}'Parameters
Send the same parameters as Curator API: Create an Ad, plus AD_ID. Every required parameter must be sent again, even with PATCH.
Parameter | Description |
|---|---|
| The ad's |
| Send them again to keep the ad's image and video. Leaving them out removes them. |
| A different feed's API ID moves the ad to that feed. |
Optional fields you leave out, such as title, url, or is_html, keep their current values.
Response
A 200 response with the updated ad (described in Curator API: Get Ads) in data.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
403 | The ad belongs to another account. |
|
404 | No ad has that ID, or it was deleted. This is checked before the parameters. |
|
422 | A required parameter is missing or not allowed, |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|