Storage Options (s3)

If you’re on the High plan, you can customize where your generated PDF or PNG files are stored by connecting your own S3 bucket.

Setting Up S3 Storage

You're on the High plan and want to store your files in a custom S3 bucket?

We’ve got a full guide on how to set up S3 connections and switch the default bucket directly from the dashboard. Check out the guide.

Configuration Options

s3_bucket

Set this to the ID of an active S3 connection to override the default storage location.

s3_key

default: pdforge/{}/

Define the path (folders and filename, without extension) where your file will be saved inside your S3 bucket.

Don’t include the file extension — we’ll handle that based on the file type (e.g., .pdf, .png).

Here's a request example for a synchronous render:

curl --location 'https://api.pdforge.com/v1/pdf/sync' \
--header 'Authorization: Bearer pdforge_api_123456789' \
--header 'Content-Type: application/json' \
--data '{
    "templateId": "template_id",
    "s3_bucket": "s3_123456789",
    "s3_key": "path/to/your/file",
    "data":{
            "currentDDate": "01/12/2025",
            "user": {
                    "name":"John Doe",
                    "email": "[e-mail]"
            },
            "details": [{"score":"100", "description":"high score"}]
    }
}
'