---
title: "Mint a short-lived upload link for a sheet or doc bundle. The bytes are then sent straight to /upload/direct — by an agent with a shell, or by a person on the returned pageUrl — so an LLM never has to carry them."
method: POST
path: "/upload/ticket"
---

# Mint a short-lived upload link for a sheet or doc bundle. The bytes are then sent straight to /upload/direct — by an agent with a shell, or by a person on the returned pageUrl — so an LLM never has to carry them.

`POST /upload/ticket`

## Request

- Base URL: `https://api.space-ocr.com`
- URL: `https://api.space-ocr.com/upload/ticket`
- Auth: HTTP bearer

## Request body

- object
  - `path` string, required: Target sheet or doc bundle path.
  - `ttlSec` integer: Link lifetime in seconds. Default 7200 (2h), max 86400 (24h).
  - `maxFiles` integer: Total files the link may accept before it stops. Default 50.

## Response `201`

Created

- unknown

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `413`: Payload Too Large
- `429`: Too Many Requests
- `500`: Internal Error
- `502`: OCR engine error (charge auto-refunded)
- `504`: OCR engine timeout (charge auto-refunded)

---

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