---
title: "POST /api/admin/discovery/batch"
method: POST
path: "/api/admin/discovery/batch"
tags: ["Admin"]
---

# POST /api/admin/discovery/batch

`POST /api/admin/discovery/batch`

## Request

- Base URL: `https://www.revuo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://www.revuo.ai/api/admin/discovery/batch`
- Auth: none declared

## Request body

- CreateBatchSessionRequest
  - `name` string, nullable, required
  - `seedUrls` string[], nullable, required
  - `maxDepth` integer
  - `maxProducts` integer
  - `isCategoryDiscovery` boolean
  - `targetCategoryId` string, nullable
  - `initialFeatureGroupIds` string[], nullable

## Response `200`

OK

- BatchDiscoverySession
  - `id` string, nullable
  - `idCreated` string, date-time
  - `name` string, nullable, required
  - `seedUrls` string[], nullable
  - `maxDepth` integer
  - `maxProducts` integer
  - `status` 'pending' | 'running' | 'paused' | 'completed' | 'cancelled'
  - `isCategoryDiscovery` boolean
  - `targetCategoryId` string, nullable
  - `initialFeatureGroupIds` string[], nullable
  - `featureSuggestions` SuggestedFeatureGroup[], nullable
    - `tempId` string, nullable, required
    - `name` string, nullable, required
    - `slug` string, nullable, required
    - `description` string, nullable
    - `aiReasoning` string, nullable
    - `confidence` number, double
    - `status` 'pending' | 'approved' | 'modified' | 'rejected'
    - `features` SuggestedFeature[], nullable
      - `tempId` string, nullable, required
      - `name` string, nullable, required
      - `slug` string, nullable, required
      - `description` string, nullable
      - `dataType` 'boolean' | 'number' | 'text' | 'enum' | 'multiEnum'
      - `enumOptions` string[], nullable
      - `aiReasoning` string, nullable
      - `confidence` number, double
      - `status` 'pending' | 'approved' | 'modified' | 'rejected'
      - `createdFeatureId` string, nullable
    - `createdFeatureGroupId` string, nullable
  - `suggestionStatus` 'notApplicable' | 'pending' | 'generated' | 'reviewed' | 'featuresCreated'
  - `createdAt` string, date-time
  - `startedAt` string, date-time, nullable
  - `completedAt` string, date-time, nullable
  - `createdByVendorId` string, nullable
  - `totalQueued` integer
  - `totalProcessed` integer
  - `totalSucceeded` integer
  - `totalFailed` integer
  - `totalSkippedDuplicate` integer
  - `discoveredProductIds` string[], nullable
  - `notes` string, nullable

## Other responses

- `default`: Error (any 4xx/5xx status), as an RFC 9457 problem document.

---

[API](https://skmtc.dev/revuo/apis/revuo-web.md) · [All operations](https://skmtc.dev/revuo/apis/revuo-web/llms.txt) · [OpenAPI document](https://skmtc.dev/revuo/apis/revuo-web/revisions/3889a7c540d3?raw)