For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
      • Overview
      • Storefront
      • Management
        • Overview
          • Addresses
          • Authentication
          • Channels
          • Company
          • Invoice Management
          • Orders
          • Payment
          • Quotes
            • GETList Quotes
            • POSTCreate Quote
            • GETList B2B Quote Custom Shipping Methods
            • POSTSend Quote Email
            • GETList Quote Extra Fields Configs
            • GETGet Quote Details
            • PUTUpdate Quote
            • DELDelete Quote
            • POSTGenerate Cart and Checkout URL for Quote
            • POSTAssign Quote to BigCommerce Order
            • POSTExport Quote PDF
            • PUTSelect Shipping Rate for Quote
            • DELRemove Selected Shipping Rate from Quote
            • GETGet Available Shipping Rates for Quote
          • Sales Staff
          • Shopping List
          • Super Admin
          • Users
  • GraphQL
    • Overview
  • MCP
    • Overview
Dev Portal
LogoLogo
RESTB2BManagementQuotes

Update Quote

PUT
https://api-b2b.bigcommerce.com/api/v3/io/rfq/:quote_id
PUT
/api/v3/io/rfq/:quote_id
$curl -X PUT https://api-b2b.bigcommerce.com/api/v3/io/rfq/123456 \
> -H "X-Auth-Token: <apiKey>" \
> -H "Content-Type: application/json" \
> -d '{}'
1{
2 "code": 200,
3 "message": "SUCCESS",
4 "data": {
5 "quoteId": 123456,
6 "quoteUrl": "https://mybcstore.com/quote/?id=195&date=1622618606"
7 }
8}
Updates an existing quote based on the details provided in the request body. Before using this endpoint to update a quote, review the following considerations: * None of the fields in the body are required for a successful response. This means that you can use this endpoint to update a single field or a subset of fields. * When adding or updating line items, you must include all existing line items that you want to keep in the quote. Omitting existing line items from a quote will remove them from the quote when you send the request. * If you add products or change discounts, you must also update the `grandTotal` and `subtotal` fields to reflect the new totals. * You cannot use this endpoint to change the sales rep or Company account assigned to an existing quote. * To update a quote’s shipping rate, use the [Select a Shipping Rate for a Quote](#select-a-shipping-rate-for-quote) endpoint. See [Create a Quote](#create-a-quote) for experience- and setting-specific requirements related to adding custom shipping or non-purchasable products to a quote. ## Archiving a quote You can use this endpoint to archive a quote by including `"status": "archived"` in the request body. Archiving hides the quote from the Buyer Portal and prevents it from being purchased. * A quote in any status can be archived.
Was this page helpful?
Previous

Get Quote Details

Next

Delete Quote

Built with

Updates an existing quote based on the details provided in the request body.

Before using this endpoint to update a quote, review the following considerations:

  • None of the fields in the body are required for a successful response. This means that you can use this endpoint to update a single field or a subset of fields.
  • When adding or updating line items, you must include all existing line items that you want to keep in the quote. Omitting existing line items from a quote will remove them from the quote when you send the request.
  • If you add products or change discounts, you must also update the grandTotal and subtotal fields to reflect the new totals.
  • You cannot use this endpoint to change the sales rep or Company account assigned to an existing quote.
  • To update a quote’s shipping rate, use the Select a Shipping Rate for a Quote endpoint.

See Create a Quote for experience- and setting-specific requirements related to adding custom shipping or non-purchasable products to a quote.

Archiving a quote

You can use this endpoint to archive a quote by including "status": "archived" in the request body. Archiving hides the quote from the Buyer Portal and prevents it from being purchased.

  • A quote in any status can be archived.

Authentication

X-Auth-Tokenstring
| Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts). | For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).
X-Store-Hashstring
HeaderArgumentDescription
X-Store-Hashstore_hashThe unique store hash associated with a BigCommerce store that has B2B Edition enabled.

Path parameters

quote_idintegerRequired
The internal numeric ID of the sales quote.

Request

This endpoint expects an object.
messagestringOptional

A message sent to the buyer via the in-quote messaging system.

userEmailstringOptionalformat: "email"

The email address of the quote’s sales rep. Any user email found within the B2B Edition System Users menu is considered a valid value for this field.

This field is optional. If left blank, it will default to the store owner’s email address as shown in the B2B Edition System Users menu.

expiredAtstringOptional

The date when the buyer can no longer purchase the quote. Use ‘%m/%d/%Y’ format when entering the expiration date.

statusenumOptional

Set to "archived" to archive the quote.

Allowed values:

Response

OK
codeanyDefaults to 200
messagestringDefaults to SUCCESS
dataobject

Errors

404
Not Found Error
HeaderArgumentDescription
X-Auth-Tokenaccess_tokenFor more about API accounts that generate access_tokens, see our Guide to API Accounts.

For example requests and more information about authenticating BigCommerce APIs, see Authentication and Example Requests.

For more about BigCommerce OAuth scopes, see our Guide to API Accounts.

For a list of API status codes, see API Status Codes.