> ## 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.

# Triggers an on-demand Reservation Rules Engine run for the caller's

> {tenantId, siteId}.


Default behavior (`sync=false`): publishes the same
`ReservationRuleEngineStart` event the cron scheduler does, returns
HTTP 202 + JobKey within ~200ms p95 (publish-and-return; no batch work
in the request thread).


Debug bypass (`?sync=true`): SKIPS kibo.jobs + RabbitMQ +
MassTransit consumer entirely. Executes the orchestrator inline on the
request thread and returns HTTP 200 with the run's final state +
elapsed milliseconds. Intended for local repro and integration smoke
only — the request can hold the thread for the full duration of the
run. Still subject to the per-{tenantId, siteId} single-writer lease,
so a concurrent async run will SKIP this one.




## OpenAPI

````yaml /openapi/openapi_commerce.json post /commerce/jobs/reservation-rules/run
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/jobs/reservation-rules/run:
    post:
      tags:
        - ReservationRules
      summary: Triggers an on-demand Reservation Rules Engine run for the caller's
      description: |
        {tenantId, siteId}.


        Default behavior (`sync=false`): publishes the same
        `ReservationRuleEngineStart` event the cron scheduler does, returns
        HTTP 202 + JobKey within ~200ms p95 (publish-and-return; no batch work
        in the request thread).


        Debug bypass (`?sync=true`): SKIPS kibo.jobs + RabbitMQ +
        MassTransit consumer entirely. Executes the orchestrator inline on the
        request thread and returns HTTP 200 with the run's final state +
        elapsed milliseconds. Intended for local repro and integration smoke
        only — the request can hold the thread for the full duration of the
        run. Still subject to the per-{tenantId, siteId} single-writer lease,
        so a concurrent async run will SKIP this one.
      parameters:
        - in: query
          name: sync
          schema:
            default: false
            type: boolean
        - description: limits which fields are returned in the response body
          in: query
          name: responseFields
          schema:
            type: string
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: JWT Authorization header using the Bearer scheme.
      scheme: bearer
      type: http

````