---
title: "Download a twin's stored file"
method: GET
path: "/voice/twins/files/download"
tags: ["Voice"]
---

# Download a twin's stored file

`GET /voice/twins/files/download`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/voice/twins/files/download`
- Auth: HTTP bearer

SPENDS NOTHING. The file's bytes, streamed. Voice checks that the key
belongs to this organisation (`twins/{org}/...`) before serving it; a key
from another organisation is voice's own 403, forwarded.

## Query parameters

- `s3_key` string, required: The stored key, as returned on the twin.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Response `200`

Successful Response

## Other responses

- `422`: Validation Error

---

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