---
title: "Render Label for Locations"
method: POST
path: "/v1/label-templates/{id}/render-locations"
tags: ["Label Templates"]
---

# Render Label for Locations

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

## 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-locations`
- Auth: API key in header `Authorization`

## Path parameters

- `id` string, required

## Request body

- V1LabelTemplateRenderLocationsRequest
  - `format` string: "png" or "pdf", defaults to "png"
  - `locationIds` string[], required
  - `pageSize` string: "Letter", "A4", or "Custom" for PDF
  - `showCutGuides` boolean: Draw light borders around labels for cutting
  - `skipLabels` integer: Leave this many positions empty on the first sheet

## Response `200`

OK

## Changes

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

[Operation history](https://skmtc.dev/sysadminsmedia/apis/homebox-api/changes/v1/label-templates/:id/render-locations/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)