Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Generate Upload URL

POST

https://api.zid.sa/v1/products/{product-id}/downloadables/generate-s3-presigned-url/

The "Generate an Upload URL" endpoint allows users to generate a pre-signed URL for uploading a digital file directly to cloud storage. This URL enables secure, temporary access for uploading files associated with a digital product.

🔑Scopes

products.read_write - Products Read & Write

Request

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/products/23fbd1f4-3e39-449f-b4f9-f90dccb60111/downloadables/generate-s3-presigned-url/' \
--header 'Store-Id: 3' \
--header 'Accept-Language: en' \
--header 'X-manager-Token: {{Access-Token}}' \
--header 'Currency: SAR' \
--header 'Role: Manager' \
--header 'Authorization: {{Autherization}}'

Responses

🟢200Success

application/json

Body

Example

{
    "response": {
        "url": "https://s3.eu-west-1.amazonaws.com/private.zid.store",
        "fields": {
            "key": "9fc92996-ffbe-4bca-9b8e-6682137fe7b6/product-downloadables/8244389b-8fe3-47dc-85ae-2f8e9e95f899",
            "AWSAccessKeyId": "AKIAXOL3MW23VCA3WLDK",
            "policy": "eyJleHBpcmF0aW9uIjogIjIwMjQtMTEtMDNUMDU6NTU6MTZaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDEwNzM3NDE4MjRdLCB7ImJ1Y2tldCI6ICJwcml2YXRlLnppZC5zdG9yZSJ9LCB7ImtleSI6ICI5ZmM5Mjk5Ni1mZmJlLTRiY2EtOWI4ZS02NjgyMTM3ZmU3YjYvcHJvZHVjdC1kb3dubG9hZGFibGVzLzgyNDQzODliLThmZTMtNDdkYy04NWFlLTJmOGU5ZTk1Zjg5OSJ9XX0=",
            "signature": "R5oESN7BQbUFL52iG64WSTaCAbw="
        }
    },
    "size_limit": 1073741824
}

🟠401Unauthorized

🔴500Internal Server error

🟠400Bad Request

🟠404Not Found

Modified at 2026-02-06 07:13:04

Create Downloadable Product

Upload File to S3