File downloads
Download a finished PDF or image with its signed link, and check the response types and download limits.
Give this prompt to your AI agent. The agent does the task for you.
Read https://thirds.ai/docs/api-reference/downloads and help me choose the right thirds.ai endpoint and write a request. Check the fields and credentials in this reference.
See all API resources or read the PDF generation API guide.
Endpoints
getDownload
GET /v1/downloads/{token}
Download a finished PDF or image
Return the finished PDF, PNG, JPEG, or WebP file a signed download link names. The link carries its own authority, so no other credential is read. The file is opened before 200 is returned: deletion that unlinks first gives 404, while a download that opens first finishes and every later download fails.
Authentication: no credential required.
| Parameter | Location | Required | Rule |
|---|---|---|---|
token | path | Yes | The signed download link. {"type":"string"} |
| Status | Meaning | Body |
|---|---|---|
| 200 | The finished PDF or image, bounded by the 25 MiB artifact limit. | application/pdf: {"type":"string","format":"binary"}; image/png: {"type":"string","format":"binary"}; image/jpeg: {"type":"string","format":"binary"}; image/webp: {"type":"string","format":"binary"} |
| 403 | The link is genuine but its time is over. | application/json: ErrorEnvelope |
| 404 | The link is not valid. This is also the answer for a link whose job or file does not exist, so a link can never be used to ask what this product holds. | application/json: ErrorEnvelope |
| 405 | The method is not allowed on this route. | application/json: ErrorEnvelope |
| 431 | The request has more than 64 headers or more than 32 KiB of header names and values. | application/json: ErrorEnvelope |
| 500 | An internal error occurred. | application/json: ErrorEnvelope |
Shared errors, headers, and authentication schemes are in shared types and security.