File downloads
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.
Download a finished PDF or image with its signed link, and check the response types and download limits.
See all API resources or read API keys and requests.
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.