First Leeward

Agentic

Select shipping option

POSThttps://api.firstleeward.com/v0/agentic/quotes/:id/shipping-option

Selects a shipping option on an existing quote and re-prices it. The response is the updated quote with a fresh amount breakdown. QUOTE_REPLACEMENT_REQUIRED means the caller must create a new quote.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Path Parameters

idstringrequired

Resource identifier

Body

application/json

shippingOptionIdstringrequired

Response

200Response for status 200
idstringrequired
shippingOptionsobject[]required
Show child attributes
idstringrequired
namestringrequired
selectedbooleanrequired
priceobjectrequired
Show child attributes
amountnumberrequired
currencystringrequired
detailsobject[]
Show child attributes
keystringrequired
valuestringrequired
amountBreakdownobjectrequired
Show child attributes
itemsSubtotalobjectrequired
Show child attributes
amountnumberrequired
currencystringrequired
shippingobject
Show child attributes
amountnumberrequired
currencystringrequired
taxobject
Show child attributes
amountobjectrequired
Show child attributes
amountnumberrequired
currencystringrequired
includedInPricesboolean
discountsobject[]required
Show child attributes
namestringrequired
amountobjectrequired
Show child attributes
amountnumberrequired
currencystringrequired
additionalChargesobject[]required
Show child attributes
namestringrequired
amountobjectrequired
Show child attributes
amountnumberrequired
currencystringrequired
finalAmountobjectrequired
Show child attributes
amountnumberrequired
currencystringrequired
expiresAtobjectrequired
400Response for status 400
Option 1 · AgenticRequestRejectedError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailnullrequired
Option 2 · OfferCodeInvalidError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailnullrequired
Option 3 · OfferCodeExpiredError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailnullrequired
Option 4 · ShippingOptionInvalidError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Show child attributes
Option 1
reasonstringrequired
messagestring
Option 2
reasonstringrequired
messagestring
Option 3
reasonstringrequired
messagestring
Option 5 · QuoteRequestRejectedError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Show child attributes
errorsobject[]required
Show child attributes
fieldstringrequired

Dot-separated path to the rejected request field; array indices are numeric segments, such as items.0.variantId

messagestring
Available options:Host must match the merchant domainMust be a canonical DNS domain without a scheme, path, or wwwMust be a valid checkout URL of at most 8192 charactersMust be a valid checkout URLMust use HTTPSMust not include credentialsMust not include an explicit portMust be a Shopify cart permalink or tokenized checkout continuationshippingAddress is required for externalCheckoutOffer code must be at most 128 charactersExactly one of items or externalCheckout is required
404Response for status 404
Option 1 · AgenticResourceNotFoundError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
Option 2 · QuoteNotFoundError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailnullrequired
409Response for status 409
Option 1 · QuoteExpiredError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailnullrequired
Option 2 · QuoteReplacementRequiredError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailnullrequired
Option 3 · QuoteNotMutableError
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailnullrequired
503Agentic Payments is temporarily unavailable
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired