---
title: "Download app version"
method: GET
path: "/apps/{name}/versions/{num}/download"
---

# Download app version

`GET /apps/{name}/versions/{num}/download`

## Request

- Base URL: `https://api.tower.dev/v1`
- URL: `https://api.tower.dev/v1/apps/{name}/versions/{num}/download`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/tower/apis/tower-api/docs/apps/:name/versions/:num/download/get.ts> (a function with typed inputs; its response is checked against the schema)

Download a tar.gz archive of the source files for an immutable app version. Excludes package-root MANIFEST, Towerfile and external shared modules. Repackage edited source files before deploying them. Range requests are ignored. A failure after streaming starts aborts the response; discard incomplete downloads.

## Path parameters

- `name` string, required: The app whose source files to download.
- `num` string, required: An immutable version number, such as 1 or v1.

## Response `200`

App source files as a gzip-compressed TAR archive

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `408`: Request Timeout
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable
- `504`: Gateway Timeout

## Changes

- **2026-10-01** `41c691e6fa2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tower/apis/tower-api/changes/apps/:name/versions/:num/download/get.md)

---

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