mind-v2

Rebuild Perspective Endpoint

Self-serve Rebuild or Re-read Conversations of a Mind (own or owned agent).

mode=reinterpret (Re-read Conversations, the default) re-extracts via the LLM extraction pipeline; a decision that cannot be re-applied afterwards comes back as a Needs Review Item. mode=reapply (alias reconstruct; Rebuild) replays the stored event log (LLM-free, instant) and requires stored events (409 if none).

scope (TOS-498, reinterpret only):

  • needs_work (default) — re-extract only the chats that need it (drifted / failed / blocked). Does NOT purge the mind; resets those chats' latest episodes to retry-eligible and lets the extraction sweep re-extract them. The targeted, cheap path the rebuild dialog uses.
  • full — purge the whole projection and re-extract every chat.

Caller must own the target Mind (self or active owner of the agent). Inactive identities are refused because their chats should not be replayed into a fresh projection. The client must pass back the estimate the user accepted so a stale dialog cannot start a more expensive rebuild.

post/api/mind/v2/perspective/{identity_id}/rebuild

Request

  • Base URL: https://app.thinqos.com (the document declares no server; this is the origin it was published from)
  • URL: https://app.thinqos.com/api/mind/v2/perspective/{identity_id}/rebuild
  • Auth: none declared

Path parameters

identity_idstring uuid required

Query parameters

mode'reapply' | 'reconstruct' | 'reinterpret'
scope'needs_work' | 'full'
include_capturesboolean

Headers

x-impersonate-identity-idstring nullable

Request body

accepted_estimated_cost_usdnumber required
candidate_recipe_refstring nullable

Response

Successful Response

object required

Changes

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