---
title: "Start a PDF upload for a handout: returns a presigned PUT straight to S3 (the web proxy caps request bodies at 10 MB). Follow with `POST {id}/handout/versions`."
method: POST
path: "/Questionnaires/{id}/handout/uploads"
tags: ["Questionnaires"]
---

# Start a PDF upload for a handout: returns a presigned PUT straight to S3 (the web proxy caps request bodies at 10 MB). Follow with \`POST {id}/handout/versions\`.

`POST /Questionnaires/{id}/handout/uploads`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/Questionnaires/{id}/handout/uploads`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/Questionnaires/:id/handout/uploads/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Request body

- InitHandoutUploadRequest: Ask for somewhere to upload a handout PDF (ITE-1474).
  - `fileName` string, required
  - `fileSize` union: The browser's size for the file, checked against the cap before any URL is issued.
    - integer
    - string, int64

## Response `200`

OK

- InitHandoutUploadResponse: A presigned PUT straight to S3 (the web proxy caps bodies at 10 MB). The browser must send `Content-Type: application/pdf`, which is signed into the URL, then call confirm with string InitHandoutUploadResponse.UploadId and the same file name.
  - `uploadId` string, required
  - `uploadUrl` string, required
  - `contentType` string, required
  - `expiresAt` string, date-time
  - `maxBytes` union
    - integer
    - string, int64

## Changes

- **2026-10-28** `099cf36186e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/Questionnaires/:id/handout/uploads/post.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)