---
title: "Update placement bid floor"
type: reference
method: POST
path: /rest-api/bid-floor/placement/{placementId}/update.do
tag: "Pricing"
---

# Update placement bid floor

`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

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `3001` | Unique numeric identifier of the placement to set the bid floor for |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | yes | `US` | ISO alpha-2 country code (e.g., 'US', 'DE') or '*' for the global default bid floor |
| `bidFloor` | number | yes | `0.50` | Minimum bid floor price value as a decimal number (e.g., 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

## Example request

```bash
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'
```

Source: https://epom.com/ad-server/docs/api/pricing/post-bid-floor-placement-update