Hindsight Cloud Docs

Appearance

Create mental model ​

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

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.

Authentication required — include an Authorization: Bearer hsk_... header. See Authentication for details.

Path Parameters ​

NameTypeRequiredDescription
bank_idstringYes

Request Body ​

Content-Type: application/json

json
{
  "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
  }
}

Example Request ​

bash
curl -X POST 'https://api.hindsight.vectorize.io/v1/default/banks/your-bank-id/mental-models' \
  -H 'Authorization: Bearer hsk_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "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
    }
  }'

Responses ​

200 — Successful Response

json
{
  "mental_model_id": "string",
  "operation_id": "Operation Id"
}

422 — Validation Error

json
{
  "detail": [
    {
      "loc": [
        null
      ],
      "msg": "Message",
      "type": "Error Type",
      "input": null,
      "ctx": {},
      "url": "URL"
    }
  ]
}

Source: /v1/default/banks/{bank_id}/mental-models