---
title: "Generate Batch"
method: POST
path: "/api/messages/generate-batch"
tags: ["Messages"]
---

# Generate Batch

`POST /api/messages/generate-batch`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/messages/generate-batch`
- Auth: none declared. Required headers: `authorization`

Generate messages for multiple orders.

Same-day restoration: If a message was already generated today for the
same order, the existing message is returned from DB without calling
Claude API. This prevents accidental double-generation (e.g. browser
closed mid-session) from consuming the user's quota or incurring API cost.

Rate limit: 10 batch requests per minute per user.

## Headers

- `x-shop-id` string, nullable: Optional shop ID
- `authorization` string, required: Bearer <token>

## Request body

- BatchGenerateRequest
  - `orders` GenerateRequest[], required
    - `order_id` string, required
    - `customer_name` string
    - `customer_email` string, nullable
    - `item_names` string[]
    - `total_price` integer
    - `is_gift` boolean
    - `delivery_context` string, nullable
    - `repeat_count` integer, nullable
    - `is_repeat` boolean, nullable
    - `mode` string
  - `restore_only` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/soeru/apis/soeru-api.md) · [All operations](https://skmtc.dev/soeru/apis/soeru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soeru/apis/soeru-api/revisions/63f8d371abed?raw)