List mental models

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

List user-curated living documents that stay current.

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

Path Parameters

Name	Type	Required	Description
bank_id	string	Yes

Query Parameters

Name	Type	Required	Description
tags	string[] | null	No	Filter by tags
tags_match	enum("any", "all", "exact")	No	How to match tags
detail	enum("metadata", "content", "full")	No	Detail level: 'metadata' (names/tags only), 'content' (adds content/config), 'full' (includes reflect_response)
limit	integer	No
offset	integer	No

Example Request

curl -X GET 'https://api.hindsight.vectorize.io/v1/default/banks/your-bank-id/mental-models' \
  -H 'Authorization: Bearer hsk_your_api_key'

Responses

200 — Successful Response

{
  "items": [
    {
      "id": "Id",
      "bank_id": "Bank Id",
      "name": "Name",
      "source_query": "string",
      "content": "string",
      "tags": [],
      "max_tokens": 0,
      "trigger": null,
      "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