---
title: "Get a run recording download URL"
method: GET
path: "/v1/runs/{id}/recording/download-url"
tags: ["testRuns"]
---

# Get a run recording download URL

`GET /v1/runs/{id}/recording/download-url`

## Request

- Base URL: `https://tester.army/api`
- URL: `https://tester.army/api/v1/runs/{id}/recording/download-url`
- Auth: none declared. Required headers: `Authorization`

Get a short-lived signed URL that downloads the run's screen recording (MP4), plus its file name and size. Use this instead of the streaming endpoint when the client should hand the link off rather than hold the bytes. Recordings become available after the run finishes; cancelled runs and runs without a recording return 404.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

Signed recording download URL

- TestRunsGetARunRecordingDownloadUrlResponse200
  - `runId` string, uuid, required
  - `fileName` string, required
  - `mediaType` string, required
  - `sizeBytes` number, double, nullable, required: Recording size in bytes, when R2 reports it
  - `downloadUrl` string, uri, required
  - `expiresIn` number, double, required: Lifetime of the URL in seconds
  - `expiresAt` string, date-time, required

## Other responses

- `400`: Bad Request - Invalid input parameters
- `401`: Unauthorized - Invalid or missing API key
- `404`: Run not found or no recording available for this run
- `429`: Too Many Requests - Usage limit exceeded
- `500`: Internal Server Error
- `504`: Gateway Timeout - Test execution exceeded time limit

## Changes

- **2026-09-12** `f6cafe2fc826`: 1 info
  - api operation id `get-a-run-recording-download-url` removed and replaced with `testRuns_getARunRecordingDownloadUrl`
- **2026-08-11** `8f4651a4866c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tester/apis/testerarmy-api/changes/v1/runs/:id/recording/download-url/get.md)

---

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