---
title: "Mint read links for a version's files"
method: GET
path: "/v1/spaces/{spaceId}/versions/{versionId}/files/links"
tags: ["Versions"]
---

# Mint read links for a version's files

`GET /v1/spaces/{spaceId}/versions/{versionId}/files/links`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/versions/{versionId}/files/links`
- Auth: HTTP bearer

Authorizes the caller once and returns one short-lived signed URL per requested path. Repeat the path parameter per file, up to 200 per request. Minting creates nothing — fetch the URLs directly; file bytes never travel through the API. A path this version does not hold answers version_file_not_found when its link is followed.

## Path parameters

- `spaceId` string, required
- `versionId` string, required

## Query parameters

- `path` string[], required: Version-relative file paths to mint read links for; repeat the parameter per path.
- `view` 'uploaded' | 'served': Which representation to read: `uploaded` is the byte the publisher uploaded before any transform; `served` is the immutable byte this version answers with.

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `versionId` string, required
    - `view` 'uploaded' | 'served', required
    - `links` object, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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