Update mental model

PATCH /v1/default/banks/{bank_id}/mental-models/{mental_model_id}

Update a mental model's name and/or source query.

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

Path Parameters

Name	Type	Required	Description
bank_id	string	Yes
mental_model_id	string	Yes

Request Body

Content-Type: application/json

{
  "max_tokens": 4096,
  "name": "Updated Team Communication Preferences",
  "source_query": "How does the team prefer to communicate?",
  "tags": [
    "team",
    "communication"
  ],
  "trigger": {
    "refresh_after_consolidation": true
  }
}

Example Request

curl -X PATCH 'https://api.hindsight.vectorize.io/v1/default/banks/your-bank-id/mental-models/your-mental-model-id' \
  -H 'Authorization: Bearer hsk_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "max_tokens": 4096,
    "name": "Updated Team Communication Preferences",
    "source_query": "How does the team prefer to communicate?",
    "tags": [
      "team",
      "communication"
    ],
    "trigger": {
      "refresh_after_consolidation": true
    }
  }'

Responses

200 — Successful Response

{
  "id": "Id",
  "bank_id": "Bank Id",
  "name": "Name",
  "source_query": "string",
  "content": "string",
  "tags": [],
  "max_tokens": 0,
  "trigger": {
    "mode": "full",
    "refresh_after_consolidation": false,
    "fact_types": [
      null
    ],
    "exclude_mental_models": false,
    "exclude_mental_model_ids": [
      null
    ],
    "tags_match": "any",
    "tag_groups": [
      null
    ],
    "include_chunks": false,
    "recall_max_tokens": 0,
    "recall_chunks_max_tokens": 0
  },
  "last_refreshed_at": "string",
  "created_at": "string",
  "reflect_response": {},
  "is_stale": false
}

422 — Validation Error

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

---

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