Create a direct upload for media

POST

https://app.trypeach.io/api/v1/medias/direct_uploads

Preferred upload flow for new integrations. Step 1: create a direct upload target. Step 2: upload the raw file bytes to the returned direct_upload.url using the returned direct_upload.headers. Step 3: call /api/v1/medias/finalize with the returned signed_id.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Body Params application/json

Example

{
    "blob": {
        "filename": "string",
        "byte_size": 0,
        "checksum": "string",
        "content_type": "string",
        "metadata": {}
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://app.trypeach.io/api/v1/medias/direct_uploads' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "blob": {
        "filename": "string",
        "byte_size": 0,
        "checksum": "string",
        "content_type": "string",
        "metadata": {}
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "id": 101,
    "key": "1/abc123",
    "filename": "sample.png",
    "content_type": "image/png",
    "metadata": {
        "source": "api",
        "peach_media_direct_upload": true,
        "account_id": 1
    },
    "byte_size": 128349,
    "checksum": "I+Sf6zGPGY+9Fh0ymkvwow==",
    "created_at": "2026-04-16T12:00:00.000Z",
    "signed_id": "eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--example",
    "direct_upload": {
        "url": "https://storage.example.com/upload",
        "headers": {
            "Content-Type": "image/png"
        }
    }
}

🟠401Unauthorized

🟠413Payload Too Large

🟠422Unprocessable Entity

Modified at 2026-04-22 04:48:04

Remove a media

Finalize a direct uploaded media