External Authorization

Upload mind data (text and media) into the owner's own AI consciousness.

Upload mind data (text and/or media tags) into the owner's own AI consciousness under an active clone:upload grant. Uploads are unbilled and quarantined for owner review unless the owner enabled auto-keep. A supplied idempotency_key deduplicates the complete request until account deletion; changing its payload is rejected. Retry processing results with the same key after retry_after_seconds. A succeeded replay means the original submission completed; it never restores a subsequently edited or deleted memory. Legacy requests without a key retain their previous behavior. Each media tag is replaced with a written description of what was uploaded, so the stored text is longer than what you send; if the result exceeds 50000 characters the request is rejected with 400. Sending fewer attachments or shorter text avoids it.

post/v1/upload_external_mind_data

Request

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

literal_textboolean

When true, upload the exact edited body without interpreting embedded media markers.

media_idsstring[] nullable

Completed controlled media IDs, checked for ownership, application, scope, retention and exact object version. No analysis is started here.

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.

textstring required
text_type'memory' | 'persona' | 'conscious' nullable
idempotency_keystring nullable

Optional for legacy clients. Reuse for retries of the same complete upload. A key is bound to the partner, grant, installation, external identity, clone, text type, text and provenance; changing any part is rejected. Receipts survive text deletion and are removed with the account.

preview_idstring nullable
source_labelstring 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
clone_idstring nullable

AI consciousness id as returned by clone operations.

text_typestring nullable
pending_owner_reviewboolean nullable
text_idstring nullable

Original submitted memory id once committed. A replay does not assert this memory still exists or restore an edited or deleted body.

status'processing' | 'succeeded' nullable

For keyed requests: processing or succeeded. Processing is not success; retry the same request and key after retry_after_seconds.

idempotent_replayboolean nullable

True when this response came from an existing durable receipt.

retry_after_secondsinteger nullable

Suggested delay before retrying the same event while processing.

Changes

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