RIrillet
Books periods

Reopens a book period

Changed on

Select the period by UUID or accounting month (YYYY-MM, for example 2026-09). Reopens the selected period and every later closed period, unlocks their subledgers, and clears stale locks on later open periods, with the same rules as reopening books in the app. closed_on is cleared. The whole cascade commits or rolls back together. A period that is already open returns 200 unchanged and does not reopen later months. Concurrent reopens of the same period are serialized; only one applies and the others return the open period unchanged. Send an Idempotency-Key to make retries safe. reason is required and stored on the reopen audit record.

post/books/periods/{book_close_period_id}/reopen

Request

Path parameters

book_close_period_idstring required
Example:2026-09

UUID or accounting month (YYYY-MM) of the period to reopen from.

Request body

reasonstring required

Why the period is being reopened. Blank or whitespace-only values are rejected. No maximum length.

Response

The requested period.

idstring uuid required
startstring date required

Book period start date (inclusive)

endstring date required

Book period end date (inclusive)

status'OPEN' | 'CLOSED' required
closed_onstring date nullable required

Date on which book was closed. Always null for open periods, and may also be null for closed periods without a recorded close date, so use status to tell whether the period is closed.

Example response

{
  "start": "2025-06-01",
  "end": "2025-06-30",
  "status": "CLOSED",
  "closed_on": "2025-07-05"
}

Changes