Execute

Change an offer's amount

The MCP modify_bid tool. Each change counts toward the per-booking cap (3 by default); once reached the answer is 409 with code REASON_CHANGE_LIMIT and the current offer stands.

patch/api/v1/offers/{offerReference}

Request

  • Base URL: https://www.upgradeagent.ai
  • URL: https://www.upgradeagent.ai/api/v1/offers/{offerReference}
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://www.upgradeagent.ai/api/oauth/authorize, token URL https://www.upgradeagent.ai/api/oauth/token, scopes: mcp)
    • HTTP bearer

Path parameters

offerReferencestring required

An offerId from the quote's options, or an offerReference (operator order-change id) from a placed offer.

Request body

quoteIdstring required
amountnumber required

The NEW amount in the offer currency.

quantityinteger
confirmboolean

Human-in-the-loop confirm (see OfferRequest.confirm).

conversationIdstring

Response

Offer updated (or re-staged for payment).

OR

Changes

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