---
title: "Batch Schedule"
method: POST
path: "/v1/batches/{batch_id}/schedule"
---

# Batch Schedule

`POST /v1/batches/{batch_id}/schedule`

## Request

- Base URL: `https://api.logimu.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.logimu.com/v1/batches/{batch_id}/schedule`
- Auth: none declared

Set / enable / disable the recurring schedule (R3: daily, weekly,
monthly). Firing is period-based (server date): daily fires on the first
scheduler tick after midnight, weekly on Monday, monthly on the 1st — at
most once per period. Each firing computes a FRESH estimate and refuses to
run (recording a cancelled run + emailing you) when the estimate exceeds
the credit ceiling or your balance (G2) — a schedule never surprises you
with a bill.

## Path parameters

- `batch_id` integer, required

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- ScheduleRequest
  - `schedule` string, required
  - `enabled` boolean: Disable without deleting the batch (R3).
  - `credit_ceiling` number, nullable: A scheduled firing whose fresh estimate exceeds this does not run — you get an email instead (G2). Default: 2x the estimate at schedule-set time.
  - `webhook_url` string, nullable: POSTed on run completion/pause, HMAC-SHA256 signed (X-Logimu-Signature: sha256=<hex>). The signing secret is returned ONCE in this response — store it.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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