Production files

Discover files and download one final production asset.

Production-file responses expose metadata and a relative download_path. The direct download returns the original final production bytes, not a proof or watermark preview. GET returns bytes; HEAD validates availability and returns headers without a body.

bash

curl --request HEAD 'https://tringify-custom-products.developers-c8a.workers.dev/api/v1/production-files/FILE_ID' \
  --header 'Authorization: Bearer cpk_live_YOUR_KEY'

The discovery endpoint is useful for a fulfillment worker that processes files as they become available. It returns only ready files and uses a cursor rather than page numbers.

Discover production files

GET production_files:read

Discover production files

Returns ready final production files for the store bound to the API key. The response is cursor-paginated and never includes source uploads, proofs, or thumbnails.

Query parameters

Name	Type	Description
`limit`	`integer`	Number of files to return. Default: `50` Example: `50`
`cursor`	`string`	Opaque cursor returned as `next_cursor` by the previous response. Example: `OPAQUE_CURSOR`

Errors

400 INVALID_CURSOR
The cursor is not a valid cursor returned by this API.
503 PRODUCTION_FILES_UNAVAILABLE
A returned file could not be verified temporarily.

curl --request GET 'https://tringify-custom-products.developers-c8a.workers.dev/api/v1/production-files?limit=50' \
  --header 'Authorization: Bearer cpk_live_YOUR_KEY'

Response

200

Sample response


{
  "success": true,
  "data": {
    "files": [
      {
        "file_id": "8fd2c4b7-2aa0-4c1e-8cd0-7db0c2df35fb",
        "order_id": "292c78e6-608b-4796-a28b-c1cc42205301",
        "order_number": "#STICKER100006",
        "order_item_id": "1e9e21f7-8d20-44b0-a9d2-4dba50f3cb35",
        "media_type": "image/png",
        "byte_size": 1843200,
        "checksum": "sha256-hex-value",
        "state": "ready",
        "download_path": "/api/v1/production-files/8fd2c4b7-2aa0-4c1e-8cd0-7db0c2df35fb"
      }
    ],
    "next_cursor": null
  }
}

Download a production file

GET production_files:read

Download a production file

Returns the final production bytes for one file. The response is private, is not cacheable, and includes the recorded content type, byte size, and checksum in response headers. Use HEAD on the same path to validate availability without downloading the body.

Path parameters

Name	Type	Description
`file_id` required	`UUID`	Opaque production-file identifier returned by an order or discovery response. Example: `8fd2c4b7-2aa0-4c1e-8cd0-7db0c2df35fb`

Errors

400 INVALID_FILE_ID
The file identifier is not a UUID.
404 PRODUCTION_FILE_NOT_FOUND
The file does not exist in the key's store.
409 PRODUCTION_FILE_NOT_READY
The final file is not ready yet.
410 PRODUCTION_FILE_EXPIRED
The final file is no longer available.
503 PRODUCTION_FILE_UNAVAILABLE
The final object could not be verified temporarily.

curl --request GET 'https://tringify-custom-products.developers-c8a.workers.dev/api/v1/production-files/FILE_ID' \
  --header 'Authorization: Bearer cpk_live_YOUR_KEY' \
  --output production-file.png

Response

200

Sample response

Binary response. The `Content-Type`, `Content-Length`, `Content-Disposition`, and `X-Artifact-Checksum` headers describe the returned final file.