---
title: "Create a short-lived clean-document download grant"
method: POST
path: "/v1/telephony/compliance-cases/{id}/uploads/{uploadId}/download:grant"
tags: ["Telephony"]
---

# Create a short-lived clean-document download grant

`POST /v1/telephony/compliance-cases/{id}/uploads/{uploadId}/download:grant`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/telephony/compliance-cases/{id}/uploads/{uploadId}/download:grant`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns a five-minute V4 URL pinned to the verified object generation. Pending, failed, or infected documents fail closed.

## Path parameters

- `id` string, required
- `uploadId` string, required

## Response `200`

Short-lived scoped download grant

- NumberComplianceSignedGrant
  - `object_ref` string
  - `signed_url` string, uri, required: Ephemeral transport credential. Never persist or log it.
  - `required_headers` object
  - `expires_at` integer, required

## Other responses

- `409`: Document has not passed verification.

---

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