Upload media file (multipart)

POST

/v1/media/upload

Multipart upload of a single file part. Returns fileName (storage path) and a short-lived readUrl (signed URL). Persist fileName in POST/PATCH /posts media[].

The part’s MIME type must be one of MediaUploadMimeType (see schema components). Other types return 400.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params multipart/form-dataRequired

Responses

🟢200

application/json

Stored object metadata

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/v1/media/upload' \
--header 'x-api-key: <api-key>' \
--form 'file=@""'

Response Example

200 - Example 1

{
    "fileName": "string",
    "fileSizeInBytes": 0,
    "contentType": "string",
    "readUrl": "http://example.com"
}

Modified at 2026-08-06 14:14:04

Configure cross-account auto-repost

Assemble chunked uploads into one file