Execute

Withdraw a placed offer

The MCP cancel_bid tool. Requires confirm=true (query or body) once the traveler has agreed; without it nothing is withdrawn (409 CONFIRMATION_REQUIRED).

delete/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.

Query parameters

quoteIdstring required

The quote id returned by POST /api/v1/quotes or /api/v1/quotes/secure.

confirmboolean

Must be true to withdraw.

Response

Offer withdrawn.

quoteIdstring required
offerReferencestring nullable required
stage'cancelled' required
status'cancelled' required
okboolean required
messagestring required
changesRemaininginteger required

Changes

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