> This page is for API. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.spreadspace.app/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.spreadspace.app/_mcp/server. # memo.reopened POST Fires once per reopen: an analyst reopened a finalized credit memo to edit it. The final PDF it points at is kept and unchanged, but the memo is under revision until the next `memo.finalized`, so mark your copy stale. The payload carries ids, not the memo. Reference: https://docs.spreadspace.app/api/api-reference/webhook-events/webhook-memo-reopened ## Request ### Headers - `SpreadSpace-Signature` (string, required) — Signature over the exact request body: `t=,v1=`. Verify it before trusting the body, and reject a `t` more than five minutes from your own clock. During a secret rotation both the new and the previous secret verify for 24 hours; each delivery is signed with exactly one. - `SpreadSpace-Event-Id` (string, required) — The event id, identical to the body's `id`. Stable across retries and replays, and shared by every endpoint one event fans out to. Delivery is at-least-once, so dedupe on it. ### Payload - `id` (string, required) — Event id: `evt_` plus 24 lowercase hex characters. Also sent as the `SpreadSpace-Event-Id` header. Stable across retries and replays, so dedupe on it. - `type` (enum, required) — Always this event type on this body. - Allowed values: `memo.reopened` - `created_at` (datetime, required) — Server-side wall-clock time the event was created, RFC 3339. Deliveries are not ordered; reconcile on this. - `tenant_id` (string, required) — The workspace the event belongs to. Reject a delivery whose tenant does not match the endpoint you registered. - `livemode` (boolean, required) — `true` for live activity, `false` for test mode (an `ss_test_` key or the sandbox simulator). Branch on it to route test deliveries to a staging handler. - `data` (MemoReopenedPayload, required) — The `data` object on a `memo.reopened` delivery, sent once per reopen: an analyst reopened a finalized credit memo to edit it. The lock is cleared and the final PDF the finalize made is KEPT, but the memo is under revision until the next `memo.finalized`, so a receiver holding a copy should mark it stale. A pointer, not a payload: ids, the time and the spread snapshots the memo was approved on, never the memo's prose or its figures. The PDF that was in force is still pulled through `GET /api/loans/{loan_id}/memos/{memo_id}/pdf`. - `api_version` (string, optional) — The API version the delivery was rendered under, a date stamp: the same value `/v1/openapi.json` reports as `info.version`. The envelope and `data` have that version's shape, and a breaking change ships under a new stamp. A delivery recorded before this field existed carries none, and has the `2026-10-07` shape. ## Types ### MemoReopenedPayload The `data` object on a `memo.reopened` delivery, sent once per reopen: an analyst reopened a finalized credit memo to edit it. The lock is cleared and the final PDF the finalize made is KEPT, but the memo is under revision until the next `memo.finalized`, so a receiver holding a copy should mark it stale. A pointer, not a payload: ids, the time and the spread snapshots the memo was approved on, never the memo's prose or its figures. The PDF that was in force is still pulled through `GET /api/loans/{loan_id}/memos/{memo_id}/pdf`. - `memo_id` (string, required) — The memo that was reopened. - `loan_id` (string, required) — The loan the memo is saved on. - `borrower_id` (string, required) — The borrower that owns the loan. - `reopened_at` (datetime, required) — Server-side wall-clock time of the reopen. - `spread_snapshots` (list of MemoReopenedPayloadSpreadSnapshotsItems, required) — The spread figures the memo was approved on when it was reopened, the same entries its `memo.finalized` carried. The reopen releases any scope the memo finalized itself. Empty when the memo had no figure exhibits. - `render_id` (string, optional, nullable) — The render behind the final PDF that was in force when the memo was reopened. Kept and unchanged; the next finalize makes a new one beside it. Null when the memo has no final PDF to name. ### MemoReopenedPayloadSpreadSnapshotsItems One entity's spread figures a finalized credit memo was approved on: the `final` attribute snapshot its figure exhibits cite, that snapshot's version, and the entity the figures belong to. A pointer, not the figures: read them from `GET /api/loans/{loan_id}/attributes/{snapshot_id}`. Carried by `memo.finalized` and `memo.reopened` and by the memo list. - `snapshot_id` (string, required) — The `final` attribute snapshot the memo's figures for this entity came from. - `version` (integer, required) — That snapshot's per-loan version number. - `entity` (MemoReopenedPayloadSpreadSnapshotsItemsEntity, required) — The entity a memo's pinned spread figures belong to: its scope `key` and display `name`. ### MemoReopenedPayloadSpreadSnapshotsItemsEntity The entity a memo's pinned spread figures belong to: its scope `key` and display `name`. - `key` (string, required) — The scope key, `business:...` or `person:...`, or `whole-loan` for the loan's own figures, such as a Global DSCR. - `name` (string, optional, nullable) — The entity's display name. Null when none was stated.