---
title: "V1 Create Download Link"
method: POST
path: "/api/v1/contracts/versions/{version_id}/download-link"
tags: ["public-api"]
---

# V1 Create Download Link

`POST /api/v1/contracts/versions/{version_id}/download-link`

## Request

- Base URL: `https://api.general.legal`
- URL: `https://api.general.legal/api/v1/contracts/versions/{version_id}/download-link`
- Auth: HTTP bearer

Issue a short-lived download link for a released version.

## Path parameters

- `version_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- DownloadLink
  - `file_name` string, required
  - `version_number` integer, nullable
  - `mime_type` string, nullable
  - `size_bytes` integer, nullable
  - `download_token` string, nullable
  - `download_token_expires_at` string, nullable
  - `download_url` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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