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

# List a version's files

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

## Request

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

Returns the version's source files with paths, sizes, and content hashes, read from the runtime's file catalog.

## Path parameters

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

## Query parameters

- `q` string: Return only files whose path contains this text.
- `view` 'uploaded' | 'served': Which catalog to list: `uploaded` (the default) is what the publisher uploaded before any transform; `served` is what this version actually 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
    - `files` object[], required
      - `path` string, required: Version-relative POSIX path. Canonicalized at intake to UTF-8 NFC, percent-decoded exactly once; max 1,024 bytes in canonical form.
      - `size` integer, required: File size in bytes.
      - `sha256` string: Optional SHA-256 content digest, 64 lowercase hex characters without the `sha256:` prefix. Omit it to let the runtime hash uploaded bytes; include it to upload by content address, with the digest verified as the bytes land.
      - `contentType` string: Optional content type for serving metadata.
      - `sourceUrl` string, uri: Optional HTTPS URL the runtime can fetch directly for this file instead of receiving bytes from the client.
      - `previewable` boolean, required
      - `generatedPreview` object, nullable, required
        - `kind` 'image', required
        - `status` 'ready' | 'pending', required
        - `key` string, required
        - `cacheScope` 'hash' | 'version-path', required
        - `contentType` 'image/webp', required
        - `width` integer, required
        - `height` integer, required
    - `index` object, required
      - `entries` object[], required
        - `key` string, required
        - `selector` union, required
          - object
            - `kind` 'hash', required
            - `sha256` string, required
          - object
            - `kind` 'path', required
            - `path` string, required
        - `primaryPath` string, required
        - `paths` string[], required
        - `count` integer, required
        - `size` integer, required
        - `totalBytes` integer, required
        - `contentTypes` string[], required
        - `previewable` boolean, required
        - `generatedPreview` object, nullable, required
          - `kind` 'image', required
          - `status` 'ready' | 'pending', required
          - `key` string, required
          - `cacheScope` 'hash' | 'version-path', required
          - `contentType` 'image/webp', required
          - `width` integer, required
          - `height` integer, required
        - `searchText` string, required
      - `byHash` object, required
      - `byPath` object, required
    - `search` object, required
      - `query` string, nullable, required
      - `total` integer, required
      - `matched` integer, 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)