Mental Models

Create mental model

Changed on Nov 7, 2026

Create a mental model by running reflect with the source query in the background. Returns an operation ID to track progress. The content is auto-generated by the reflect endpoint. Use the operations endpoint to check completion status.

post/v1/default/banks/{bank_id}/mental-models

Request

Base URL
https://hindsight.vectorize.io (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/vectorize/apis/hindsight-http-api/docs/v1/default/banks/:bank_id/mental-models/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

bank_idstring required

Headers

authorizationstring nullable

Request body

idstring nullable

Optional custom ID for the mental model (same rules as a bank id: at most 192 bytes of UTF-8, no '/' and no control characters)

namestring required

Human-readable name for the mental model

source_querystring required

The query to run to generate content

tagsstring[]

Tags for scoped visibility

max_tokensinteger

Maximum tokens for generated content

Example request

{
  "id": "team-communication",
  "max_tokens": 2048,
  "name": "Team Communication Preferences",
  "source_query": "How does the team prefer to communicate?",
  "tags": [
    "team"
  ],
  "trigger": {
    "refresh_after_consolidation": false
  }
}

Response

Successful Response

mental_model_idstring nullable

ID of the created mental model

operation_idstring required

Operation ID to track refresh progress

Changes

Nov 7, 202645e711cd0897 Revision changes
- info
  added the new optional request property /
Oct 4, 20264fda98b75f63 Revision changes
- warning
  removed the optional property // from the response with the status
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /////
- info
  added the new optional request property ////////
- info
  added the new optional request property ///////////
- info
  added the new optional request property /////////////
- info
  added the new optional request property //////////
- info
  added the new optional request property ////////
- info
  added the new optional request property //////////
- info
  added the new optional request property ///////
- info
  added the new exact enum value to the request property /////
- info
  added the new exact enum value to the request property ////////
- info
  added the new exact enum value to the request property ///////////
- info
  added the new exact enum value to the request property /////////////
- info
  added the new exact enum value to the request property //////////
- info
  added the new exact enum value to the request property ////////
- info
  added the new exact enum value to the request property //////////
- info
  added the new exact enum value to the request property ///////
- info
  added the new exact enum value to the request property //

Operation history (3 revisions)