---
title: "Metadata for a shareable file link"
method: GET
path: "/api/public/files/{hash}"
tags: ["public"]
---

# Metadata for a shareable file link

`GET /api/public/files/{hash}`

## Request

- Base URL: `https://telawiki.com`
- URL: `https://telawiki.com/api/public/files/{hash}`
- Auth: none required

Backs the human-facing `/f/{hash}/{name}` page. The owning `page` is included only when its space is published.

## Response `200`

File metadata.

- object
  - `file` PublicFile, required
    - `hash` string, required
    - `short` string, required: The 12-character hash prefix used in `/f/` links.
    - `name` string, required
    - `mime` string, required
    - `kind` string, required: Coarse category driving how the file page previews it.
    - `byte_size` integer, required
    - `url` string, required: Where the bytes are served.
    - `path` string, required: The file page's own path.
    - `page` object: The page this file hangs off. Present only when that page's space is published.
      - `id` integer
      - `title` string
      - `path` string
      - `space_name` string

## Other responses

- `404`: `not_found`.
- `500`: `internal` — server error.

---

[API](https://skmtc.dev/telawiki/apis/tela-rest-api.md) · [All operations](https://skmtc.dev/telawiki/apis/tela-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telawiki/apis/tela-rest-api/revisions/f316f31f6fcb?raw)