---
title: "Update Template"
method: PATCH
path: "/v2/custom-table-templates/{template_id}"
tags: ["custom-table-templates"]
---

# Update Template

`PATCH /v2/custom-table-templates/{template_id}`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/custom-table-templates/{template_id}`
- Auth: HTTP bearer

Update a Custom Table Template

## Path parameters

- `template_id` string, required

## Request body

- UpdateCustomTableTemplateRequest
  - `name` string, nullable
  - `entity_type` string, nullable
  - `columns` object[], nullable
  - `include_totals` boolean, nullable
  - `aging_summary_position` 'above' | 'below' | 'hidden': Where a custom table shows its aging summary row, if at all.
  - `include_unapplied_payments` boolean, nullable

## Response `200`

Successful Response

- CustomTableTemplateSchema
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `name` string, required: User-facing display name for this table template.
  - `entity_type` string, required: Which data list to iterate, e.g. 'overdue_invoices', 'open_invoices'.
  - `columns` object[], required: Ordered array of {key, header} dicts defining the table columns.
  - `include_totals` boolean, required: Whether to append a totals row summing amount/balance columns.
  - `aging_summary_position` 'above' | 'below' | 'hidden', required: Where a custom table shows its aging summary row, if at all.
  - `include_unapplied_payments` boolean, required: Whether to include unapplied payment rows alongside invoices and credit memos.
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

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