---
title: "GET /experimental/launch-runs/{id}/live-progress"
method: GET
path: "/experimental/launch-runs/{id}/live-progress"
tags: ["Launch Runs"]
---

# GET /experimental/launch-runs/{id}/live-progress

`GET /experimental/launch-runs/{id}/live-progress`

Returns the content of one live-progress file uploaded by a running or completed launch run. Returns `204 No Content` while the file has not been uploaded yet. Only `metrics.json` and `prepare-subphases.json` are accessible. A `metrics.json` returned mid-run may carry `"partial": true`.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `filename` union, required
  - 'metrics.json'
  - 'prepare-subphases.json'

## Headers

- `Authorization` string

## Response `200`

Default Response

- unknown

## Other responses

- `204` — Default Response
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-15** `d50a02b79ad3` — 2 info
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/url` to the response with the `403` status
- **2026-09-15** `050f3217cf2c` — 1 breaking, 1 info
  - removed the enum value `metrics.json` from the `query` request parameter `filename`
  - for the `query` request parameter `filename`, the type was generalized from `string` to no type
- **2026-09-11** `04f88c57328e` — 3 breaking, 2 info
  - the `query` request parameter `filename` was restricted to a list of enum values
  - removed the media type `application/x-ndjson` for the response with the status `200`
  - removed the media type `text/plain` for the response with the status `200`
  - added the new enum value `metrics.json` to the `query` request parameter `filename`
  - …1 more
- **2026-09-03** `538ff8b269b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/launch-runs/:id/live-progress/get.md)

---

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