API Endpoints Quick Reference

Fresh

Base URL: https://api.hindsight.vectorize.ioAuth: Authorization: Bearer hsk_your-api-keyAPI Version: 0.4.20

Core Memory Operations

Method	Endpoint	Description
POST	/v1/default/banks/{bank_id}/memories	Retain — Store memories
POST	/v1/default/banks/{bank_id}/memories/recall	Recall — Search memories
POST	/v1/default/banks/{bank_id}/reflect	Reflect — AI reasoning

Memory Banks

Method	Endpoint	Description
GET	/v1/default/banks	List all banks
GET	/v1/default/banks/{bank_id}	Get bank profile
PATCH	/v1/default/banks/{bank_id}	Update bank
DELETE	/v1/default/banks/{bank_id}	Delete bank

Memories

Method	Endpoint	Description
GET	/v1/default/banks/{bank_id}/memories	List memories
GET	/v1/default/banks/{bank_id}/memories/{id}	Get memory
DELETE	/v1/default/banks/{bank_id}/memories/{id}	Delete memory
DELETE	/v1/default/banks/{bank_id}/memories	Clear all memories

Mental Models

Method	Endpoint	Description
POST	/v1/default/banks/{bank_id}/mental-models	Create mental model
GET	/v1/default/banks/{bank_id}/mental-models	List mental models
GET	/v1/default/banks/{bank_id}/mental-models/{id}	Get mental model
PATCH	/v1/default/banks/{bank_id}/mental-models/{id}	Update mental model
DELETE	/v1/default/banks/{bank_id}/mental-models/{id}	Delete mental model
POST	/v1/default/banks/{bank_id}/mental-models/{id}/refresh	Refresh mental model

Documents

Method	Endpoint	Description
GET	/v1/default/banks/{bank_id}/documents	List documents
GET	/v1/default/banks/{bank_id}/documents/{id}	Get document
DELETE	/v1/default/banks/{bank_id}/documents/{id}	Delete document

Operations

Method	Endpoint	Description
GET	/v1/default/banks/{bank_id}/operations	List operations
GET	/v1/default/banks/{bank_id}/operations/{id}	Get operation status
POST	/v1/default/banks/{bank_id}/operations/{id}/cancel	Cancel operation

Scoped API Keys

Method	Endpoint	Description
POST	/v1/api-keys/scoped	Create scoped child key
GET	/v1/api-keys/scoped	List scoped keys
DELETE	/v1/api-keys/scoped/{id}	Revoke scoped key

MCP Endpoints

Mode	URL
Single-Bank	https://api.hindsight.vectorize.io/mcp/{bank_id}/
Multi-Bank	https://api.hindsight.vectorize.io/mcp

SDKs

Language	Package	Install
Python	hindsight-client	pip install hindsight-client
TypeScript	@vectorize-io/hindsight-client	npm install @vectorize-io/hindsight-client