---
title: "Get Template File Route"
method: HEAD
path: "/templates/{template_identifier}/files"
---

# Get Template File Route

`HEAD /templates/{template_identifier}/files`

## Request

- Base URL: `https://api.goodeye.dev/v1`
- URL: `https://api.goodeye.dev/v1/templates/{template_identifier}/files`
- Auth: none declared

Fetch a single file from a template version's file tree.

``path`` must match a row in the template's file manifest (use
``get_template`` to see the manifest). ``SKILL.md`` returns the template
body. Text files return the decoded string in ``content``. Small binary
files return base64-encoded bytes in ``content_base64``. Binary files over
the size limit return metadata and an ``error`` field with no inline bytes.

Pass ``format=raw`` to receive the file's raw bytes instead of the JSON
envelope. This is the path public template pages use to render demo images:
a validated image is served with its pinned image type, anything else is
served as a generic download attachment, and every raw response carries
hardening headers so a file can never execute as an active document in a
browser. Pair ``format=raw`` with ``sha256`` so the URL is content
addressed: a republished or removed file no longer resolves at a stale
address. The default (no ``format``) JSON response is unchanged.

Anonymous callers may fetch files from live (published) template versions.
Once a version is unpublished, anonymous reads are denied immediately; the
liveness check is evaluated per read inside the same transaction, including
for ``format=raw``.

When ``path`` is omitted this is not a file request: the greedy ``:path``
segment swallowed a template whose slug is literally ``files`` (an
``@handle/files`` URL), so fall through to ordinary template resolution on
the reconstructed identifier. Publishing a new template with that slug is
rejected up front, but legacy templates created before this route existed
must still resolve here. (Per-file fetches against such a legacy template
cannot be disambiguated from this route and are not supported, but those
rows predate sibling files so their only file is the synthesized SKILL.md,
which the no-path body resolution already returns.)

## Path parameters

- `template_identifier` string, required

## Query parameters

- `path` string, nullable: Relative path of the file within the template's file tree
- `version` integer, nullable
- `format` string, nullable: Set to 'raw' to return the file's raw bytes (used to render images on public template pages). Omit for the default structured JSON response.
- `sha256` string, nullable: Content address of the expected file. When provided, the file is resolved by path and then confirmed to match this value; a stale or mismatched address returns not found.

## Headers

- `accept` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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