---
title: "Update Entity Template"
method: PUT
path: "/v1/templates/{id}"
tags: ["Entity Templates"]
---

# Update Entity Template

`PUT /v1/templates/{id}`

## Path parameters

- `id` string, required

## Request body

- RepoEntityTemplateUpdate
  - `defaultDescription` string, nullable
  - `defaultInsured` boolean
  - `defaultLifetimeWarranty` boolean
  - `defaultLocationId` string, nullable — Default location and tags
  - `defaultManufacturer` string, nullable
  - `defaultModelNumber` string, nullable
  - `defaultName` string, nullable
  - `defaultQuantity` number, nullable — Default values for entities
  - `defaultTagIds` string[], nullable
  - `defaultWarrantyDetails` string, nullable
  - `description` string
  - `fields` RepoTemplateField[] — Custom fields
    - `booleanValue` boolean
    - `id` string
    - `name` string
    - `numberValue` integer
    - `textValue` string
    - `timeValue` string
    - `type` string
  - `id` string
  - `includePurchaseFields` boolean
  - `includeSoldFields` boolean
  - `includeWarrantyFields` boolean — Metadata flags
  - `name` string, required
  - `notes` string

## Response `200`

OK

- RepoEntityTemplateOut
  - `createdAt` string
  - `defaultDescription` string
  - `defaultInsured` boolean
  - `defaultLifetimeWarranty` boolean
  - `defaultLocation` RepoTemplateLocationSummary
    - `id` string
    - `name` string
  - `defaultManufacturer` string
  - `defaultModelNumber` string
  - `defaultName` string
  - `defaultQuantity` number — Default values for entities
  - `defaultTags` RepoTemplateTagSummary[]
    - `id` string
    - `name` string
  - `defaultWarrantyDetails` string
  - `description` string
  - `fields` RepoTemplateField[] — Custom fields
    - `booleanValue` boolean
    - `id` string
    - `name` string
    - `numberValue` integer
    - `textValue` string
    - `timeValue` string
    - `type` string
  - `id` string
  - `includePurchaseFields` boolean
  - `includeSoldFields` boolean
  - `includeWarrantyFields` boolean — Metadata flags
  - `name` string
  - `notes` string
  - `updatedAt` string

## Changes

- **2026-04-17** `c7da38893e9d` — 2 info
  - api tag `Entity Templates` added
  - api tag `Item Templates` removed
- **2025-12-06** `c1f0cb371a55` — 1 info
  - endpoint added
- **2024-11-29** `19794fb70c24` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/sysadminsmedia/apis/homebox-api/changes/v1/templates/:id/put.md)

---

[API](https://skmtc.dev/sysadminsmedia/apis/homebox-api.md) · [All operations](https://skmtc.dev/sysadminsmedia/apis/homebox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sysadminsmedia/homebox-api/revisions/f19934d1b3ab/schema)