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

# Retry Failed Import or Review Jobs

> Retry 1–20 jobs with durable background execution. Requires catalog:write.

### Targets

jobIds accepts import UUIDs, bulk_... developer job handles, or review_<batch UUID> for a Review job (including jobs created in the app). Inputs are trimmed, bounded, and deduplicated in first-requested order.

### Retry scope

stages=all retries failed source rows and linked review stages; stages=images retries failed review images only. Completed work, applied products, cancelled stages, and active work are preserved. Optional brandKitIds replaces image-source selection using the kits' current organization-owned websites. Omit it to keep frozen sources. To resume interrupted dispatch, pass an importretry_... handle without overrides; the saved target plan is reused.

### Results

Use the returned ordered results and retryJobIds; partial enqueue failures remain explicit. HTTP 202 means accepted, not successful generation. Read every retry handle with getBulkImportRetry or jobs.wait. Newly imported rows enter the normal Review pipeline.



## OpenAPI

````yaml /openapi.json post /api/v1/products/bulk-import/retry
openapi: 3.1.0
info:
  title: OmniCommerce API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://omnicommerce.sg/terms
  description: >-
    OmniCommerce API surface for agents and developer integrations. Includes
    public endpoints (merchant discovery, product search, compare, catalog, ACO
    retrieval) and authenticated endpoints (product management via API key
    Bearer tokens).
servers:
  - url: https://omnicommerce.sg
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: agentic-checkout
    description: Merchant-fulfilled agentic checkout
    x-group: Agentic Checkout
  - name: agents
    description: agents
    x-group: Agents
  - name: analytics
    description: Sales performance across marketplaces
    x-group: Analytics
  - name: aops
    description: Agent operating procedures
    x-group: AOPs
  - name: branding
    description: branding
    x-group: Branding
  - name: campaigns
    description: Campaign briefs, offer windows, and marketplace runs
    x-group: Campaigns
  - name: developer-platform
    description: Authenticated developer platform APIs
    x-group: Developer Platform
  - name: documents
    description: Knowledge base document uploads
    x-group: Knowledge Base
  - name: looks
    description: AI-styled product looks
    x-group: Looks
  - name: oauth
    description: OAuth token endpoints
    x-group: OAuth
  - name: orders
    description: Workspace and agentic orders
    x-group: Orders
  - name: organizations
    description: Organization management
    x-group: Organizations
  - name: price-books
    description: Marketplace list-price markup rules
    x-group: Price Books
  - name: products
    description: Product CRUD, bulk import, enrichment, publish, and delist
    x-group: Products
  - name: promotions
    description: Central promotions and marketplace sync
    x-group: Promotions
  - name: public-agent
    description: Public agent discovery and catalog APIs
    x-group: Public Agent
  - name: returns
    description: returns
    x-group: Returns
  - name: reviews
    description: Marketplace product reviews and seller replies
    x-group: Reviews
  - name: settlements
    description: settlements
    x-group: Settlements
  - name: ucp
    description: Universal Commerce Protocol
    x-group: UCP
paths:
  /api/v1/products/bulk-import/retry:
    post:
      tags:
        - products
      summary: Retry Failed Import or Review Jobs
      description: >-
        Retry 1–20 jobs with durable background execution. Requires
        catalog:write.


        ### Targets


        jobIds accepts import UUIDs, bulk_... developer job handles, or
        review_<batch UUID> for a Review job (including jobs created in the
        app). Inputs are trimmed, bounded, and deduplicated in first-requested
        order.


        ### Retry scope


        stages=all retries failed source rows and linked review stages;
        stages=images retries failed review images only. Completed work, applied
        products, cancelled stages, and active work are preserved. Optional
        brandKitIds replaces image-source selection using the kits' current
        organization-owned websites. Omit it to keep frozen sources. To resume
        interrupted dispatch, pass an importretry_... handle without overrides;
        the saved target plan is reused.


        ### Results


        Use the returned ordered results and retryJobIds; partial enqueue
        failures remain explicit. HTTP 202 means accepted, not successful
        generation. Read every retry handle with getBulkImportRetry or
        jobs.wait. Newly imported rows enter the normal Review pipeline.
      operationId: post_v1_products_bulk_import_retry
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                organizationId:
                  type: string
                  minLength: 1
                  maxLength: 120
                jobIds:
                  minItems: 1
                  maxItems: 20
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 160
                  description: >-
                    1–20 import UUIDs or bulk_... developer handles. Use
                    review_<batch UUID> for a Review job, or importretry_...
                    without overrides to resume interrupted dispatch. Duplicates
                    are removed in first-requested order.
                stages:
                  default: all
                  description: >-
                    Retry failed work only. all includes failed source rows and
                    review stages; images retries only failed review images.
                  type: string
                  enum:
                    - all
                    - images
                brandKitIds:
                  description: >-
                    Replace the image-source kit selection for failed images
                    using current saved websites. Omit to retain the previous
                    selection.
                  maxItems: 500
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 120
                model:
                  type: string
                  minLength: 1
                  maxLength: 120
              required:
                - jobIds
              additionalProperties: false
      responses:
        '202':
          description: Ordered retry acceptance results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  apiVersion:
                    type: string
                    const: developer_v1
                  operationId:
                    type: string
                  status:
                    type: string
                    enum:
                      - accepted
                      - completed
                      - failed
                  jobId:
                    type: string
                  warnings:
                    type: array
                    items:
                      type: string
                  recommendations:
                    type: array
                    items:
                      type: string
                  links:
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties:
                      type: string
                  data:
                    type: object
                    properties:
                      success:
                        type: boolean
                      jobIds:
                        type: array
                        items:
                          type: string
                      retryJobIds:
                        type: array
                        items:
                          type: string
                      succeededCount:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      failedCount:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            jobId:
                              type: string
                            success:
                              type: boolean
                            retryJobId:
                              type: string
                            error:
                              type: string
                          required:
                            - jobId
                            - success
                    required:
                      - success
                      - jobIds
                      - retryJobIds
                      - succeededCount
                      - failedCount
                      - results
                required:
                  - ok
                  - apiVersion
                  - operationId
                  - status
                  - warnings
                  - recommendations
                  - links
                  - data
        '400':
          description: Invalid request.
        '401':
          description: Missing credentials.
        '403':
          description: Missing OAuth scope or organization capability.
        '404':
          description: Resource not found in this organization.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Bearer API key for server-to-server access. Session auth is also
        supported in first-party UI flows.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.