---
title: "Create a review batch"
method: POST
path: "/workspaces/{workspaceSlug}/practices/review-batches"
tags: ["review-batch"]
---

# Create a review batch

`POST /workspaces/{workspaceSlug}/practices/review-batches`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/workspaces/{workspaceSlug}/practices/review-batches`
- Auth: HTTP bearer

## Path parameters

- `workspaceSlug` string, required

## Request body

- CreateReviewBatchRequest
  - `budgetUsd` string, nullable, required
  - `from` string, date-time, nullable, required
  - `itemKind` string, required
  - `to` string, date-time, nullable, required

## Response `201`

Created

- ReviewBatch
  - `budgetUsd` string, nullable, required
  - `confirmedBy` AccountRef, required
    - `avatarUrl` string, nullable, required
    - `displayName` string, nullable, required
    - `id` string, required
    - `identities` ProviderIdentityRef[], required
      - `avatarUrl` string, nullable, required
      - `displayName` string, nullable, required
      - `login` string, nullable, required
      - `provider` 'GITHUB' | 'GITLAB' | 'SLACK' | 'OUTLINE', required
    - `status` 'UNCLAIMED' | 'ACTIVE' | 'SUSPENDED' | 'DELETING' | 'DELETED', required
  - `createdAt` string, date-time, required
  - `estimatedCostUsd` string, nullable, required
  - `estimatedItems` integer, required
  - `etag` string, required
  - `failedCount` integer, required
  - `finishedAt` string, date-time, nullable, required
  - `from` string, date-time, nullable, required
  - `id` string, uuid, required
  - `itemKind` string, required
  - `origin` 'BACKFILL' | 'SCHEDULE', required
  - `pauseReason` 'BUDGET_EXHAUSTED' | 'REVIEW_MODEL_UNBOUND' | 'WORKSPACE_UNAVAILABLE' | 'PAUSED_BY_ADMIN' | 'null', nullable, required
  - `requestedBy` AccountRef, required
    - `avatarUrl` string, nullable, required
    - `displayName` string, nullable, required
    - `id` string, required
    - `identities` ProviderIdentityRef[], required
      - `avatarUrl` string, nullable, required
      - `displayName` string, nullable, required
      - `login` string, nullable, required
      - `provider` 'GITHUB' | 'GITLAB' | 'SLACK' | 'OUTLINE', required
    - `status` 'UNCLAIMED' | 'ACTIVE' | 'SUSPENDED' | 'DELETING' | 'DELETED', required
  - `reviewIds` string[], required
  - `scheduleId` string, uuid, nullable, required
  - `skippedCount` integer, required
  - `startedAt` string, date-time, nullable, required
  - `status` 'AWAITING_CONFIRMATION' | 'RUNNING' | 'PAUSED' | 'COMPLETED' | 'CANCELLED', required
  - `submittedCount` integer, required
  - `targetItemIds` string, required
  - `to` string, date-time, nullable, required
  - `version` string, required

## Changes

- **2026-10-17** `4b8a89bf492c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/changes/workspaces/:workspaceSlug/practices/review-batches/post.md)

---

[API](https://skmtc.dev/hephaestus-build/apis/hephaestus-api.md) · [All operations](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hephaestus-build/apis/hephaestus-api/revisions/3592ab716973?raw)