---
title: "Update a package template"
method: PATCH
path: "/api/templates/package-templates/{id}"
tags: ["templates"]
---

# Update a package template

`PATCH /api/templates/package-templates/{id}`

## Request

- Base URL: `https://api.vepathos.com`
- URL: `https://api.vepathos.com/api/templates/package-templates/{id}`
- Auth: HTTP bearer

## Request body

- PackageTemplatePatch
  - `name` string, required
  - `description` string
  - `method` string: Defaults to DELIVERY when omitted.
  - `weight` string
  - `weight_unit` string: Defaults to KILOGRAMS when omitted.
  - `width` string
  - `height` string
  - `depth` string
  - `length_unit` string: Defaults to CENTIMETER when omitted.
  - `packaging` string: Defaults to BOX when omitted.
  - `handling` string[]
  - `value` string
  - `value_currency` string: Defaults to USD when omitted.

## Response `200`

Updated package template.

- PackageTemplate: Saved dimension, weight and handling preset. Enum-like fields are stored as plain strings; the referenced enums document the accepted values rather than enforce them.
  - `id` string, required
  - `name` string, required
  - `description` string
  - `method` 'DELIVERY' | 'PICKUP' | 'SIGNATURE', required
  - `weight` string, required
  - `weight_unit` 'GRAMS' | 'KILOGRAMS' | 'OUNCES' | 'POUNDS', required
  - `width` string, required
  - `height` string, required
  - `depth` string, required
  - `length_unit` 'CENTIMETER' | 'METER' | 'KILOMETER' | 'INCH' | 'FEET' | 'MILE', required
  - `packaging` 'BOX' | 'ENVELOPE' | 'BAG' | 'CARTON' | 'PALLET' | 'SHRINK_WRAP', required
  - `handling` SpecialHandling[], required
  - `value` string, required: Declared value, in cents (e.g. "5000" = $50.00).
  - `value_currency` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid request body
- `401`: Not signed in
- `404`: Not found, or not owned by the caller

---

[API](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api.md) · [All operations](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api/revisions/00caa1ca62d9?raw)
