External Authorization

Prepare a verified memory from an explicitly selected owner conversation.

post/v1/consolidate_external_conversation

Request

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

current_textstring required
clone_responsestring required
speaker_labelstring nullable

Neutral display name of whoever is sending this message, shown to the AI consciousness as who it is currently talking to.

source_labelstring nullable
media_idsstring[] nullable
purpose'conversation' | 'reading'
owner_notesstring 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
status'processing' | 'ready' | 'empty' | 'failed'

Current authorization or invocation lifecycle state.

textstring nullable
auto_keep_external_memoriesboolean
retry_after_secondsinteger nullable

Suggested delay before retrying the same event while processing.

preview_idstring nullable

Changes

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