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

Responses

🟢201Success

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

🟠400Bad Request

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.zid.sa/v1/products/f894ca76-3f29-43c7-868d-4274f50f537f/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}}'

Response Example

201 - Example 1

{
    "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
}

Modified at 2026-02-11 09:43:17

Create Downloadable Product

Upload File to S3