> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel an item on a Blanket Order

> Cancel an item on a Blanket Order.



## OpenAPI

````yaml /openapi/openapi_commerce.json post /commerce/blanketorders/{blanketOrderId}/items/{itemId}/cancel
openapi: 3.0.1
info:
  description: |-
    <div id="overview_COMMERCE">
                <h2>COMMERCE</h2>
                <p>The Commerce API interacts with the commerce entities of your tenant, including shoppers's active shopping
                    carts, checkouts, submitted orders, wishlists, and returns as well as B2B quotes.</p>
                <p>Use the <strong>Carts</strong> resource to manage storefront shopping carts as shoppers add and remove items for purchase.
                    Each time a shopper's cart is modified, the Carts resource updates the estimated total with any
                    applicable
                    discounts.</p>
                <p>Use the <strong>Channels</strong> and <strong>Channel Groups</strong> resources to manage the channels a company uses to create logical
                    commercial business divisions based on region or types of sales, such as "US Online," "Amazon," or "EMEA
                    Retail."
                    All orders include a channel association that enables the company to perform financial reporting for
                    each defined channel.
                    Because channels are managed at the tenant level, you must associate all the tenant's sites with a
                    channel. Sites that do not
                    have a defined channel association cannot successfully submit orders.</p>
                <p>Use the <strong>Checkouts</strong> resource to track a shopper's order items and their intended destinations on sites that
                    have the multiple shipment feature enabled.</p>
                <p>Use the <strong>Orders</strong> resource to manage all components of order processing, payment, and order-level
                    fulfillment.</p>
                <p>Use the <strong>Quotes</strong> resource to support B2B functionality by managing order quotes, similar to wishlists.</p>
                <p>Use the <strong>Returns</strong> resource to manage returned items that were previously fufilled. Returns can include any
                    number of items associated with an original
                    order. Each return must either be associated with an original order or a product definition to represent
                    each returned item.</p>
                <p>Use the <strong>Wish Lists</strong> resource to manage the shopper wish lists of products associated with a customer
                    account. Although customer accounts are managed at the tenant
                    level, the system stores shopper wish lists at the site level. This enables the same customer to have
                    wish lists for each of a merchant's sites. The <strong>Wish List Items</strong>
                    resource allows you to manage the individual items in a wish list.</p>
            </div>
  title: Cart/Checkout/Quote
  version: 0.0.1
servers:
  - description: Kibo Base URL
    url: '{baseUrl}/api'
    variables:
      baseUrl:
        default: https://t1000000.sb.usc1.gcp.kibocommerce.com
        description: Base URL
security:
  - bearerAuth: []
paths:
  /commerce/blanketorders/{blanketOrderId}/items/{itemId}/cancel:
    post:
      tags:
        - BlanketOrder
      summary: Cancel an item on a Blanket Order
      description: Cancel an item on a Blanket Order.
      parameters:
        - in: path
          name: blanketOrderId
          required: true
          schema:
            type: string
        - in: path
          name: itemId
          required: true
          schema:
            type: string
        - description: limits which fields are returned in the response body
          in: query
          name: responseFields
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommerceRuntimeCanceledReason'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlanketOrderItem'
            text/json:
              schema:
                $ref: '#/components/schemas/BlanketOrderItem'
            text/plain:
              schema:
                $ref: '#/components/schemas/BlanketOrderItem'
          description: OK
components:
  schemas:
    CommerceRuntimeCanceledReason:
      allOf:
        - $ref: '#/components/schemas/Reason'
        - additionalProperties: false
          type: object
    BlanketOrderItem:
      description: "A single product commitment within a Blanket Order.\r\nEach line tracks its own lifecycle independently."
      properties:
        attributes:
          description: "Line-level extensible attributes. Use Mozu.CommerceRuntime.Contracts.BlanketOrders.BlanketOrderAttribute on\r\n`BlanketOrder.Attributes` for header-level attributes."
          items:
            $ref: '#/components/schemas/BlanketOrderItemAttribute'
          nullable: true
          type: array
        auditInfo:
          $ref: '#/components/schemas/CoreApiContractsAuditInfo'
        consumedQuantity:
          description: Total quantity consumed by call-off orders. System-managed.
          format: int32
          type: integer
        id:
          description: Unique identifier for this line. System-supplied.
          nullable: true
          type: string
        lineId:
          description: Auto-assigned sequential line number within the order.
          format: int32
          nullable: true
          type: integer
        product:
          $ref: '#/components/schemas/BlanketOrderProductReference'
        quantity:
          description: Total committed quantity for this product line.
          format: int32
          type: integer
        remainingQuantity:
          description: >-
            Remaining available quantity (Quantity - ConsumedQuantity).
            System-managed.
          format: int32
          type: integer
        status:
          description: Current line status managed by the line-level transition table.
          nullable: true
          type: string
        unitPrice:
          description: Agreed unit price for this product line.
          format: double
          type: number
      type: object
    Reason:
      properties:
        description:
          nullable: true
          type: string
        moreInfo:
          nullable: true
          type: string
        reasonCode:
          nullable: true
          type: string
      type: object
    BlanketOrderItemAttribute:
      description: "Attribute instance on a Blanket Order line item.\r\nSeparate from Mozu.CommerceRuntime.Contracts.BlanketOrders.BlanketOrderAttribute (header-level) for type safety\r\nand to allow consumers to distinguish header vs line attributes."
      properties:
        attributeDefinitionId:
          format: int32
          nullable: true
          type: integer
        auditInfo:
          $ref: '#/components/schemas/CoreApiContractsAuditInfo'
        fullyQualifiedName:
          nullable: true
          type: string
        values:
          items: {}
          nullable: true
          type: array
      type: object
    CoreApiContractsAuditInfo:
      properties:
        createBy:
          nullable: true
          type: string
        createDate:
          format: date-time
          nullable: true
          type: string
        updateBy:
          nullable: true
          type: string
        updateDate:
          format: date-time
          nullable: true
          type: string
      type: object
    BlanketOrderProductReference:
      description: "Lightweight product identity for Blanket Order Items.\r\nContains the minimum fields needed to identify and display the product."
      properties:
        name:
          description: Product display name.
          nullable: true
          type: string
        productCode:
          description: Product code used for identification.
          nullable: true
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: JWT Authorization header using the Bearer scheme.
      scheme: bearer
      type: http

````