External Authorization

Authorize one exact media upload to the owner’s granted AI consciousness.

post/v1/request_external_media_upload

Request

  • Base URL: https://partner.mindupload.app
  • URL: https://partner.mindupload.app/v1/request_external_media_upload
  • 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.

access_tokenstring required

Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users.

installation_idstring required

Your stable opaque identifier for this app installation.

external_subjectstring required

Your stable opaque identifier for the person authorizing this installation.

clone_idstring required

AI consciousness id as returned by clone operations.

idempotency_keystring required

A stable opaque event key that makes exact retries return the same outcome.

filenamestring required
content_type'application/ogg' | 'audio/3gpp' | 'audio/aac' | 'audio/m4a' | 'audio/mp3' | 'audio/mp4' | 'audio/mpeg' | 'audio/ogg' | 'audio/wav' | 'audio/wave' | 'audio/webm' | 'audio/x-m4a' | 'audio/x-wav' | 'image/gif' | 'image/heic' | 'image/heif' | 'image/jpeg' | 'image/png' | 'image/webp' | 'video/3gpp' | 'video/avi' | 'video/mp4' | 'video/ogg' | 'video/quicktime' | 'video/webm' | 'video/x-flv' | 'video/x-m4v' | 'video/x-matroska' | 'video/x-ms-wmv' | 'video/x-msvideo' required
file_size_bytesinteger required
media_type'image' | 'video' | 'audio' required

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

Response

Result envelope — check the success field.

successboolean

Whether the call succeeded.

error_messagestring nullable

Human-readable reason when success is false.

error_codestring
upload_idstring nullable

Multipart upload session id returned by request_multipart_upload.

presigned_urlstring nullable

Temporary URL where the client uploads the file or part.

content_typestring nullable
file_size_bytesinteger nullable
expires_atinteger nullable

UNIX timestamp when this resource or capability expires.

idempotent_replayboolean nullable

True when this response came from an existing durable receipt.

required_headersobject nullable

Send these exact headers with the PUT, including the signed If-None-Match: * condition. An existing object answers 412; inspect/start its stored analysis to recover a lost acknowledgement, never remove the condition.

Changes

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