Media

Request an upload slot and a signed viewing link for a media attachment.

post/v1/request_upload_url

Request

  • Base URL: https://partner.mindupload.app
  • URL: https://partner.mindupload.app/v1/request_upload_url
  • Auth: API key in header X-Partner-Key

Request body

preferred_languagestring nullable

BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages.

usernamestring nullable

The end-user's username.

passwordstring nullable

The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage.

filenamestring nullable
content_typestring nullable
file_size_bytesinteger nullable
media_typestring nullable

The kind of media: image, video, or audio.

has_thumbnailboolean nullable
thumbnail_file_size_bytesinteger nullable

Response

Result envelope — check the success field.

successboolean

Whether the call succeeded.

error_messagestring nullable

Human-readable reason when success is false.

error_codestring
r2_keystring nullable

Opaque media object key returned by upload-start operations and reused for multipart upload calls.

presigned_urlstring nullable

Temporary URL where the client PUTs the file. Valid for 60 minutes.

media_urlstring nullable

Media URL returned by this operation; use signed read URLs unchanged.

signed_media_urlstring nullable

Temporary readable media URL.

thumbnail_r2_keystring nullable

Opaque thumbnail media object key, present only when a thumbnail upload was requested.

thumbnail_presigned_urlstring nullable

Temporary URL where the client PUTs the thumbnail. Valid for 60 minutes.

signed_thumbnail_urlstring nullable

Temporary readable thumbnail URL.

Changes

No recorded changes to this operation across all 2 revisions of this API.