POST /v3/item/:id/auto-bid

POST

/v3/item/{itemId}/auto-bid

const url = 'https://api-ha-prod-p8.handbid.dev/v3/item/example/auto-bid';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': '*/*'},
  body: '"{\n  \"maxAmount\": 100\n}"'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api-ha-prod-p8.handbid.dev/v3/item/example/auto-bid \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: */*' \
  --data '"{\n  \"maxAmount\": 100\n}"'

NEW (HAN-1687, 2026-05-06). Set or update an auto-bid (max bid ceiling).

Body:

maxAmount (required, positive number) — ceiling in DOLLARS.

Response (200): same shape as POST /bid. autoBidMax is now non-null and reflects the configured ceiling.

Internally an HbMaxBid row is created/updated and an associated HbBid advances the proxy ladder to one increment below the new max (or to current+increment, whichever is higher). Same V1 validation pipeline as POST /bid.

Authorizations

bearer

Parameters

Path Parameters

itemId

required

string

Request Body

*/*

string

Example

"{\n  \"maxAmount\": 100\n}"

Responses

200

Successful response

application/json