BlueCart API

The BlueCart API is defined using REST with predictable, resource-oriented URLs and returns JSON-encoded responses with standard HTTP status codes. It is authenticated using AWS Signature Version 4 against the AWS execute-api service in the us-east-1 region, requiring an Access Key ID, Secret Access Key, and API Key generated from the BlueCart app under Settings, API Access Credentials. The API operates on one object per request and does not support bulk updates, uses next-token pagination returning 25 items per page on collection endpoints, and ships with a Postman collection to help developers make their first request. It exposes resources for orders, products, catalogs, clients, and users.

OpenAPI Specification

bluecart-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: BlueCart API
  version: '1.0'
  description: >-
    The BlueCart API is a REST API for the BlueCart wholesale ordering and
    procurement platform serving the hospitality and food and beverage
    industries. It exposes resource-oriented endpoints for managing orders,
    products, catalogs, clients, and users, returning JSON-encoded responses
    with standard HTTP status codes. The API is authenticated using AWS
    Signature Version 4 against the AWS execute-api service in the us-east-1
    region, operates on a single object per request (no bulk updates), and uses
    next-token pagination returning 25 items per page on collection endpoints.
    This specification was generated from the public BlueCart API documentation
    at https://docs.bluecart.com/.
  contact:
    name: BlueCart
    url: https://www.bluecart.com/contact
  x-generated-from: documentation
  x-last-validated: '2026-06-02'
servers:
- url: https://{invokeUrl}
  description: >-
    BlueCart API AWS API Gateway invoke URL. The concrete host is provided in
    the BlueCart-supplied Postman collection (variable) and via your BlueCart
    account; it is not published in the public docs.
  variables:
    invokeUrl:
      default: api.bluecart.com
      description: AWS API Gateway invoke URL for the BlueCart API.
tags:
- name: Orders
  description: Search, retrieve, place, and modify wholesale orders.
- name: Products
  description: Manage the product catalog including pricing and inventory.
- name: Catalogs
  description: Manage client-specific catalogs of products and pricing.
- name: Clients
  description: Manage buyer/client associations and their account details.
- name: Users
  description: Manage platform users and their roles and notifications.
paths:
  /orders/:
    get:
      operationId: searchOrders
      summary: Search For Orders
      description: >-
        Retrieves a page of orders (25 at a time) filtered by the supplied
        search parameters. Use the returned nextToken to page through results.
      tags:
      - Orders
      parameters:
      - name: client
        in: query
        description: Include client information in the response.
        required: false
        schema:
          type: boolean
      - name: vendor
        in: query
        description: Include vendor information in the response.
        required: false
        schema:
          type: boolean
      - name: status
        in: query
        description: Filter orders by status.
        required: false
        schema:
          type: string
          enum:
          - New
          - Processing
          - In-Transit/Shipped
          - Fulfilled
          - Cancelled
      - name: sortField
        in: query
        description: Field to sort results by.
        required: false
        schema:
          type: string
          enum:
          - creationDate
          - requestedDeliveryDate
          - deliveryDate
          - shippingDate
      - name: creationStartDate
        in: query
        description: Filter by order creation start date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - name: creationEndDate
        in: query
        description: Filter by order creation end date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - name: requestedDeliveryStartDate
        in: query
        description: Filter by requested delivery start date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - name: requestedDeliveryEndDate
        in: query
        description: Filter by requested delivery end date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - name: deliveryStartDate
        in: query
        description: Filter by delivery start date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - name: deliveryEndDate
        in: query
        description: Filter by delivery end date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - name: shippingStartDate
        in: query
        description: Filter by shipping start date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - name: shippingEndDate
        in: query
        description: Filter by shipping end date (YYYY-MM-DD).
        required: false
        schema:
          type: string
          format: date
      - $ref: '#/components/parameters/NextToken'
      responses:
        '200':
          description: A page of matching orders.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderList'
              examples:
                SearchOrders200Example:
                  summary: Default searchOrders 200 response
                  x-microcks-default: true
                  value:
                    orders:
                    - orderId: 100245
                      clientId: 5012
                      vendorId: 880
                      status: New
                      deliveryType: Delivery
                      currency: USD
                      deliveryCharge: 25
                      requestedDeliveryDate: '2026-06-10'
                      deliveryDate: '2026-06-10'
                      shippingDate: '2026-06-09'
                      creationDate: '2026-06-02T14:30:00Z'
                      lastUpdateDate: '2026-06-02T15:00:00Z'
                      products:
                      - {}
                      addresses: {}
                      totals: {}
                    nextToken: eyJsYXN0SWQiOjEwMDI0NX0=
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: placeOrder
      summary: Place An Order
      description: Creates a new wholesale order on behalf of a client.
      tags:
      - Orders
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderCreate'
            examples:
              PlaceOrderRequestExample:
                summary: Default placeOrder request
                x-microcks-default: true
                value:
                  clientId: 5012
                  user:
                    id: 3001
                    type: STAFF
                  deliveryCharge: 25
                  deliveryType: Delivery
                  requestedDeliveryDate: '2026-06-10'
                  currency: USD
                  addresses: {}
                  products:
                  - productId: 90210
                    sku: WINE-CAB-750
                    name: Cabernet Sauvignon 750ml
                    quantity: 12
                    price: 18.5
                  presetCreationDate: '2026-06-02T14:30:00Z'
      responses:
        '200':
          description: The created order, with any warnings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderCreateResult'
              examples:
                PlaceOrder200Example:
                  summary: Default placeOrder 200 response
                  x-microcks-default: true
                  value:
                    order:
                      orderId: 100245
                      clientId: 5012
                      vendorId: 880
                      status: New
                      deliveryType: Delivery
                      currency: USD
                      deliveryCharge: 25
                      requestedDeliveryDate: '2026-06-10'
                      deliveryDate: '2026-06-10'
                      shippingDate: '2026-06-09'
                      creationDate: '2026-06-02T14:30:00Z'
                      lastUpdateDate: '2026-06-02T15:00:00Z'
                      products:
                      - productId: {}
                        sku: {}
                        name: {}
                        quantity: {}
                        price: {}
                      addresses: {}
                      totals: {}
                    warnings: &id006
                    - Requested delivery date is outside the standard window.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orders/{id}:
    get:
      operationId: retrieveOrder
      summary: Retrieve An Order
      description: Retrieves a single order by its identifier.
      tags:
      - Orders
      parameters:
      - $ref: '#/components/parameters/OrderId'
      - name: client
        in: query
        description: Include client information in the response.
        required: false
        schema:
          type: boolean
      - name: vendor
        in: query
        description: Include vendor information in the response.
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: The requested order.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Order'
              examples:
                RetrieveOrder200Example:
                  summary: Default retrieveOrder 200 response
                  x-microcks-default: true
                  value:
                    orderId: 100245
                    clientId: 5012
                    vendorId: 880
                    status: New
                    deliveryType: Delivery
                    currency: USD
                    deliveryCharge: 25
                    requestedDeliveryDate: '2026-06-10'
                    deliveryDate: '2026-06-10'
                    shippingDate: '2026-06-09'
                    creationDate: '2026-06-02T14:30:00Z'
                    lastUpdateDate: '2026-06-02T15:00:00Z'
                    products:
                    - productId: 90210
                      sku: WINE-CAB-750
                      name: Cabernet Sauvignon 750ml
                      quantity: 12
                      price: 18.5
                    addresses: {}
                    totals: {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: modifyOrder
      summary: Modify An Order
      description: Updates an existing order identified by its identifier.
      tags:
      - Orders
      parameters:
      - $ref: '#/components/parameters/OrderId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderUpdate'
            examples:
              ModifyOrderRequestExample:
                summary: Default modifyOrder request
                x-microcks-default: true
                value:
                  userId: 3001
                  status: Processing
                  deliveryCharge: 25
                  requestedDeliveryDate: '2026-06-10'
                  deliveryDate: '2026-06-10'
                  shippingDate: '2026-06-09'
                  paymentStatus: Paid
                  trackingInfo: 1Z999AA10123456784
                  addresses: {}
                  products:
                  - productId: 90210
                    sku: WINE-CAB-750
                    name: Cabernet Sauvignon 750ml
                    quantity: 12
                    price: 18.5
      responses:
        '200':
          description: The updated order.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Order'
              examples:
                ModifyOrder200Example:
                  summary: Default modifyOrder 200 response
                  x-microcks-default: true
                  value:
                    orderId: 100245
                    clientId: 5012
                    vendorId: 880
                    status: New
                    deliveryType: Delivery
                    currency: USD
                    deliveryCharge: 25
                    requestedDeliveryDate: '2026-06-10'
                    deliveryDate: '2026-06-10'
                    shippingDate: '2026-06-09'
                    creationDate: '2026-06-02T14:30:00Z'
                    lastUpdateDate: '2026-06-02T15:00:00Z'
                    products:
                    - productId: 90210
                      sku: WINE-CAB-750
                      name: Cabernet Sauvignon 750ml
                      quantity: 12
                      price: 18.5
                    addresses: {}
                    totals: {}
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /products/:
    get:
      operationId: retrieveAllProducts
      summary: Retrieve All Products
      description: >-
        Retrieves a page of products (25 at a time) filtered by optional search
        parameters. Use the returned nextToken to page through results.
      tags:
      - Products
      parameters:
      - name: sku
        in: query
        description: Filter products by SKU.
        required: false
        schema:
          type: string
      - name: name
        in: query
        description: Filter products by name.
        required: false
        schema:
          type: string
      - name: description
        in: query
        description: Filter products by description.
        required: false
        schema:
          type: string
      - $ref: '#/components/parameters/NextToken'
      responses:
        '200':
          description: A page of products.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductList'
              examples:
                RetrieveAllProducts200Example:
                  summary: Default retrieveAllProducts 200 response
                  x-microcks-default: true
                  value:
                    products:
                    - productId: 90210
                      productName: Cabernet Sauvignon 750ml
                      sku: WINE-CAB-750
                      description: Estate-bottled Cabernet Sauvignon, vintage 2022.
                      uom: Bottle
                      price: 18.5
                      pack: 12
                      tags: &id001
                      - Wine
                      - Red
                      inventory: {}
                      discounts: {}
                      creationDateTime: '2026-06-02T14:30:00Z'
                      lastUpdateDateTime: '2026-06-02T15:00:00Z'
                    nextToken: eyJsYXN0SWQiOjkwMjEwfQ==
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/products/:
    post:
      operationId: createProduct
      summary: Create A Product
      description: Creates a new product in the catalog.
      tags:
      - Products
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductCreate'
            examples:
              CreateProductRequestExample:
                summary: Default createProduct request
                x-microcks-default: true
                value:
                  productName: Cabernet Sauvignon 750ml
                  sku: WINE-CAB-750
                  description: Estate-bottled Cabernet Sauvignon, vintage 2022.
                  uom: Bottle
                  price: 18.5
                  pack: 12
                  tags: &id002
                  - Wine
                  - Red
                  inventory: {}
                  discounts: {}
      responses:
        '200':
          description: The created product.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Product'
              examples:
                CreateProduct200Example:
                  summary: Default createProduct 200 response
                  x-microcks-default: true
                  value:
                    productId: 90210
                    productName: Cabernet Sauvignon 750ml
                    sku: WINE-CAB-750
                    description: Estate-bottled Cabernet Sauvignon, vintage 2022.
                    uom: Bottle
                    price: 18.5
                    pack: 12
                    tags: *id001
                    inventory: {}
                    discounts: {}
                    creationDateTime: '2026-06-02T14:30:00Z'
                    lastUpdateDateTime: '2026-06-02T15:00:00Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/products/{id}:
    get:
      operationId: retrieveProduct
      summary: Retrieve A Product
      description: Retrieves a single product by its identifier.
      tags:
      - Products
      parameters:
      - $ref: '#/components/parameters/ProductId'
      responses:
        '200':
          description: The requested product.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Product'
              examples:
                RetrieveProduct200Example:
                  summary: Default retrieveProduct 200 response
                  x-microcks-default: true
                  value:
                    productId: 90210
                    productName: Cabernet Sauvignon 750ml
                    sku: WINE-CAB-750
                    description: Estate-bottled Cabernet Sauvignon, vintage 2022.
                    uom: Bottle
                    price: 18.5
                    pack: 12
                    tags: *id001
                    inventory: {}
                    discounts: {}
                    creationDateTime: '2026-06-02T14:30:00Z'
                    lastUpdateDateTime: '2026-06-02T15:00:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateProduct
      summary: Update A Product
      description: Updates an existing product identified by its identifier.
      tags:
      - Products
      parameters:
      - $ref: '#/components/parameters/ProductId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductCreate'
            examples:
              UpdateProductRequestExample:
                summary: Default updateProduct request
                x-microcks-default: true
                value:
                  productName: Cabernet Sauvignon 750ml
                  sku: WINE-CAB-750
                  description: Estate-bottled Cabernet Sauvignon, vintage 2022.
                  uom: Bottle
                  price: 18.5
                  pack: 12
                  tags: *id002
                  inventory: {}
                  discounts: {}
      responses:
        '200':
          description: The updated product.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Product'
              examples:
                UpdateProduct200Example:
                  summary: Default updateProduct 200 response
                  x-microcks-default: true
                  value:
                    productId: 90210
                    productName: Cabernet Sauvignon 750ml
                    sku: WINE-CAB-750
                    description: Estate-bottled Cabernet Sauvignon, vintage 2022.
                    uom: Bottle
                    price: 18.5
                    pack: 12
                    tags: *id001
                    inventory: {}
                    discounts: {}
                    creationDateTime: '2026-06-02T14:30:00Z'
                    lastUpdateDateTime: '2026-06-02T15:00:00Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteProduct
      summary: Delete A Product
      description: Deletes a product identified by its identifier.
      tags:
      - Products
      parameters:
      - $ref: '#/components/parameters/ProductId'
      responses:
        '200':
          description: True when the product was deleted.
          content:
            application/json:
              schema:
                type: boolean
                example: true
              examples:
                DeleteProduct200Example:
                  summary: Default deleteProduct 200 response
                  x-microcks-default: true
                  value: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/catalogs/:
    get:
      operationId: retrieveAllCatalogs
      summary: Retrieve All Catalogs
      description: >-
        Retrieves a page of catalogs. Use the returned nextToken to page through
        results.
      tags:
      - Catalogs
      parameters:
      - $ref: '#/components/parameters/NextToken'
      responses:
        '200':
          description: A page of catalogs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogList'
              examples:
                RetrieveAllCatalogs200Example:
                  summary: Default retrieveAllCatalogs 200 response
                  x-microcks-default: true
                  value:
                    catalogs:
                    - catalogId: 700
                      catalogName: Premium Wines
                      enabled: true
                      products:
                      - {}
                      clients:
                      - {}
                    nextToken: eyJsYXN0SWQiOjcwMH0=
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createCatalog
      summary: Create A Catalog
      description: Creates a new catalog with products and assigned customers.
      tags:
      - Catalogs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CatalogCreate'
            examples:
              CreateCatalogRequestExample:
                summary: Default createCatalog request
                x-microcks-default: true
                value:
                  catalogName: Premium Wines
                  products:
                  - {}
                  customers:
                  - {}
      responses:
        '200':
          description: The created catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
              examples:
                CreateCatalog200Example:
                  summary: Default createCatalog 200 response
                  x-microcks-default: true
                  value:
                    catalogId: 700
                    catalogName: Premium Wines
                    enabled: true
                    products:
                    - {}
                    clients:
                    - {}
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/catalogs/{id}:
    get:
      operationId: retrieveCatalog
      summary: Retrieve A Catalog
      description: Retrieves a single catalog by its identifier.
      tags:
      - Catalogs
      parameters:
      - $ref: '#/components/parameters/CatalogId'
      responses:
        '200':
          description: The requested catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
              examples:
                RetrieveCatalog200Example:
                  summary: Default retrieveCatalog 200 response
                  x-microcks-default: true
                  value:
                    catalogId: 700
                    catalogName: Premium Wines
                    enabled: true
                    products:
                    - {}
                    clients:
                    - {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateCatalog
      summary: Update A Catalog
      description: Updates an existing catalog identified by its identifier.
      tags:
      - Catalogs
      parameters:
      - $ref: '#/components/parameters/CatalogId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CatalogUpdate'
            examples:
              UpdateCatalogRequestExample:
                summary: Default updateCatalog request
                x-microcks-default: true
                value:
                  catalogName: Premium Wines
                  enabled: true
                  products:
                  - {}
                  customers:
                  - {}
      responses:
        '200':
          description: The updated catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
              examples:
                UpdateCatalog200Example:
                  summary: Default updateCatalog 200 response
                  x-microcks-default: true
                  value:
                    catalogId: 700
                    catalogName: Premium Wines
                    enabled: true
                    products:
                    - {}
                    clients:
                    - {}
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteCatalog
      summary: Delete A Catalog
      description: Deletes a catalog identified by its identifier.
      tags:
      - Catalogs
      parameters:
      - $ref: '#/components/parameters/CatalogId'
      responses:
        '200':
          description: True when the catalog was deleted.
          content:
            application/json:
              schema:
                type: boolean
                example: true
              examples:
                DeleteCatalog200Example:
                  summary: Default deleteCatalog 200 response
                  x-microcks-default: true
                  value: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/clients/:
    post:
      operationId: createClient
      summary: Create A Client Association
      description: >-
        Creates a new client association linking a buyer to the distributor,
        including catalog assignment, ordering, and account details.
      tags:
      - Clients
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClientCreate'
            examples:
              CreateClientRequestExample:
                summary: Default createClient request
                x-microcks-default: true
                value:
                  clientEmail: [email protected]
                  clientId: 5012
                  name: Downtown Bistro
                  catalogId: 700
                  orderFrequency: Weekly
                  accountNumber: ACCT-5012
                  netTerms: Net 30
                  addresses: {}
                  salesReps: &id007
                  - 3001
      responses:
        '200':
          description: The created client.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Client'
              examples:
                CreateClient200Example:
                  summary: Default createClient 200 response
                  x-microcks-default: true
                  value:
                    clientId: 5012
                    clientEmail: [email protected]
                    name: Downtown Bistro
                    firstName: Jordan
                    lastName: Rivera
                    nickname: DTB
                    catalogId: 700
                    orderFrequency: Weekly
                    accountNumber: ACCT-5012
                    netTerms: Net 30
                    addresses: {}
                    salesReps: &id003
                    - 3001
                    status: Active
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/clients/{id}:
    get:
      operationId: retrieveClient
      summary: Retrieve A Client
      description: Retrieves a single client by its identifier.
      tags:
      - Clients
      parameters:
      - $ref: '#/components/parameters/ClientId'
      responses:
        '200':
          description: The requested client.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Client'
              examples:
                RetrieveClient200Example:
                  summary: Default retrieveClient 200 response
                  x-microcks-default: true
                  value:
                    clientId: 5012
                    clientEmail: [email protected]
                    name: Downtown Bistro
                    firstName: Jordan
                    lastName: Rivera
                    nickname: DTB
                    catalogId: 700
                    orderFrequency: Weekly
                    accountNumber: ACCT-5012
                    netTerms: Net 30
                    addresses: {}
                    salesReps: *id003
                    status: Active
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateClient
      summary: Update A Client
      description: Updates an existing client identified by its identifier.
      tags:
      - Clients
      parameters:
      - $ref: '#/components/parameters/ClientId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClientUpdate'
            examples:
              UpdateClientRequestExample:
                summary: Default updateClient request
                x-microcks-default: true
                value:
                  firstName: Jordan
                  lastName: Rivera
                  catalogId: 700
                  orderFrequency: Weekly
                  accountNumber: ACCT-5012
                  nickname: DTB
                  addresses: {}
                  salesReps:
                  - 0
                  status: Active
      responses:
        '200':
          description: The updated client.
          content:
     

# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bluecart/refs/heads/main/openapi/bluecart-openapi.yml