InvoiceTemplates

Lists invoice templates available to the caller's organization. The first page also prepends built-in system defaults so the picker always has a baseline.

Creates a new invoice template owned by the caller's organization. The template's TemplateJSON is validated against the current schema and stamped with the current schema version on write.

Placeholder endpoint for uploading a logo to attach to an invoice template. Currently returns NOT_IMPLEMENTED until logo storage lands.

Returns a single invoice template by ID. System defaults are resolved from in-memory definitions; custom templates come from the org's repository.

Updates an org-owned invoice template. Requires expected_version for optimistic locking - fetch the template first and submit the version you read so concurrent edits cannot silently clobber each other.

Soft-deletes an org-owned invoice template. System defaults cannot be deleted.

Creates a writable copy of the given template under the caller's organization. System defaults are duplicated by snapshotting the in-memory baseline.

Renders a sample PDF using the stored template, or - if a template_json body is supplied - using that unsaved draft. Useful for live preview while editing in the builder. The response body is the PDF bytes; rendered output is short-TTL cached so repeated calls return identical bytes.

Marks the given org-owned invoice template as the organization's default template used when no per-customer template is selected. System templates cannot be set as default - duplicate them first.

Returns a lightweight SVG schematic of the template (block layout in theme colors) suitable for cards in a template picker. Strongly cached with an ETag keyed on the template's updated_at - clients should send If-None-Match.