---
title: "Render Labels for an Asset ID Range"
method: POST
path: "/v1/label-templates/{id}/render-assets"
tags: ["Label Templates"]
---

# Render Labels for an Asset ID Range

`POST /v1/label-templates/{id}/render-assets`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/label-templates/{id}/render-assets`
- Auth: API key in header `Authorization`

Renders one label per asset ID in the range. Asset IDs that no entity has yet get a label with only the asset ID and asset URL, for pre-printing tags.

## Path parameters

- `id` string, required

## Request body

- V1LabelTemplateRenderAssetsRequest
  - `endAssetId` integer
  - `format` string: "png" or "pdf", defaults to "pdf"
  - `pageSize` string: "Letter" or "A4" for PDF
  - `showCutGuides` boolean: Draw light borders around labels for cutting
  - `skipLabels` integer: Empty slots before the first label, for partly used sheets
  - `startAssetId` integer

## Response `200`

OK

## Changes

- **2026-10-31** `f055e84c5599`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sysadminsmedia/apis/homebox-api/changes/v1/label-templates/:id/render-assets/post.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.dev/sysadminsmedia/apis/homebox-api/revisions/316b3e623d70?raw)