---
title: "Download a job output (transcript supports format conversion)"
method: GET
path: "/api/v1/jobs/{id}/outputs/{role}/download"
tags: ["Jobs"]
---

# Download a job output (transcript supports format conversion)

`GET /api/v1/jobs/{id}/outputs/{role}/download`

## Request

- Base URL: `https://api.weftly.ai`
- URL: `https://api.weftly.ai/api/v1/jobs/{id}/outputs/{role}/download`
- Auth: API key in header `Authorization`

## Path parameters

- `id` string, uuid, required
- `role` string, required

## Query parameters

- `format` 'srt' | 'txt' | 'vtt' | 'json' | 'words' | 'edit': Transcript format (only for role=transcript). Omit or "srt" for presigned URL; "txt", "vtt", "json", "words", or "edit" returns converted content directly.

## Response `200`

Download URL (JSON) or transcript content (when format is txt/vtt/json)

- DownloadUrlResponse
  - `download_url` string, uri, required
  - `output_id` string, uuid

## Other responses

- `400`: Invalid format
- `404`: Not found

---

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