Create an upload

post

https://reprtoir.io/api/uploads

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The parameters to create a new upload.

file_url

url

A publicly-reachable URL to download the file from. When provided, no upload_url is returned and the upload starts in processing status. When omitted, the response includes an upload_url to PUT the file to, and the upload starts in draft status.

filename

string

required

The original filename of the file being uploaded with its extension. Example: "artwork.jpg" or "audio.wav".

reference

string

An internal reference for this upload, echoed back as-is on subsequent GET calls.

resource_uuid

string

required

The UUID of the resource to attach the upload to once processed. Required for all currently supported type values.

type

string

enum

required

The type of resource being uploaded.

Allowed:

Headers

X-API-Version

string

Defaults to 2026-06-29

Determines the date-based API version of your API call. If none is provided, the API version associated to your API key will be used.

Responses

201The upload has been created (attachment flow).

404The resource_uuid does not resolve to an existing resource.

422The type parameter is unknown.