Update placement bid floor

Creates a new or updates an existing bid floor entry for the specified placement and country combination.

Reference

POST https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/{placementId}/update.do

Creates a new or updates an existing bid floor entry for the specified placement and country combination. The country parameter accepts an ISO alpha-2 country code (e.g., 'US', 'DE') or '*' for a global default bid floor. The bidFloor value sets the minimum CPM price for the placement in that country. Requires both ENABLED or READONLY level on INVENTORY permission and ENABLED level on BID_FLOOR_MANAGEMENT permission.

Path Params

placementId integer required

Unique numeric identifier of the placement to set the bid floor for

3001

Form Params

country string required

ISO alpha-2 country code (e.g., 'US', 'DE') or '*' for the global default bid floor

US

bidFloor number required

Minimum bid floor price value as a decimal number (e.g., 0.50)

0.50

Responses

200

Placement bid floor updated successfully

400

Bad request — invalid or missing parameters

401

Authentication error

403

Permission denied

404

Not found — resource does not exist

Language

cURL Request

curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'country=US' \
  --data-urlencode 'bidFloor=0.50'

Python Request

import requests

response = requests.request("POST", "https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do", headers={"X-Api-Key": "YOUR_API_KEY"}, data={"country": "US", "bidFloor": "0.50"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do', {
  method: 'POST',
  headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({"country":"US","bidFloor":"0.50"}),
});

console.log(await response.json());

Java Request

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do"))
    .header("X-Api-Key", "YOUR_API_KEY")
    .header("Content-Type", "application/x-www-form-urlencoded")
    .method("POST", HttpRequest.BodyPublishers.ofString("country=US&bidFloor=0.50"))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

C# Request

using var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("POST"), "https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do");
request.Headers.Add("X-Api-Key", "YOUR_API_KEY");
request.Content = new FormUrlEncodedContent(new Dictionary<string, string> { ["country"] = "US", ["bidFloor"] = "0.50" });

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Go Request

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do", strings.NewReader(`country=US&bidFloor=0.50`))
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

PHP Request

<?php
$ch = curl_init("https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY", "Content-Type: application/x-www-form-urlencoded"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'country=US&bidFloor=0.50');

echo curl_exec($ch);
curl_close($ch);

Ruby Request

require 'net/http'
require 'json'

uri = URI("https://YOUR-NETWORK-DOMAIN/rest-api/bid-floor/placement/3001/update.do")
request = Net::HTTP::Post.new(uri)
request['X-Api-Key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/x-www-form-urlencoded'
request.set_form_data('country' => "US", 'bidFloor' => "0.50")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body