Raise an existing sealed bid within the grant's mandate.

Raise an existing sealed bid within the grant's mandate.

post/v1/agent/bids/{bidId}/increase

Request

  • Base URL: https://api.nowyourlink.com
  • URL: https://api.nowyourlink.com/v1/agent/bids/{bidId}/increase
  • Auth: OAuth 2 (authorization code, authorization URL https://api.nowyourlink.com/oauth/authorize, token URL https://api.nowyourlink.com/oauth/token, scopes: bids:write)

Path parameters

bidIdstring required

Bid to raise.

Headers

Idempotency-Keystring required

Client-chosen unique key, 1-255 visible ASCII characters. The same key returns the same result.

Request body

daystring date required

Settled auction date in UTC, YYYY-MM-DD.

ad_idstring required

Owned, approved creative id.

amount_centsinteger required

Any cent amount in range. The mandate's max_bid_cents caps it further.

currency'EUR' required

Response

Bid raised (or replayed for a repeated Idempotency-Key). The body is the auction state.

daystring date required

Settled auction date in UTC, YYYY-MM-DD.

phase'IDLE' | 'OPEN' | 'CLOSED' required
openedAtstring date-time nullable
closedAtstring date-time nullable
bidCountinteger required
closesAtstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.