---
title: "Partial update memory bank"
method: PATCH
path: "/v1/default/banks/{bank_id}"
tags: ["Banks"]
---

# Partial update memory bank

`PATCH /v1/default/banks/{bank_id}`

## Request

- Base URL: `https://hindsight.vectorize.io` (the document declares no server; this is the origin it was published from)
- URL: `https://hindsight.vectorize.io/v1/default/banks/{bank_id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vectorize/apis/hindsight-http-api/docs/v1/default/banks/:bank_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Partially update an agent's profile. Only provided fields will be updated.

## Path parameters

- `bank_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- CreateBankRequest: Request model for creating/updating a bank.
  - `name` string, nullable: Deprecated: display label only, not advertised
  - `disposition` DispositionTraits: Disposition traits that influence how memories are formed and interpreted.
    - `skepticism` integer, required: How skeptical vs trusting (1=trusting, 5=skeptical)
    - `literalism` integer, required: How literally to interpret information (1=flexible, 5=literal)
    - `empathy` integer, required: How much to consider emotional context (1=detached, 5=empathetic)
  - `disposition_skepticism` integer, nullable: Deprecated: use update_bank_config instead
  - `disposition_literalism` integer, nullable: Deprecated: use update_bank_config instead
  - `disposition_empathy` integer, nullable: Deprecated: use update_bank_config instead
  - `mission` string, nullable: Deprecated: use update_bank_config with reflect_mission instead
  - `background` string, nullable: Deprecated: use update_bank_config with reflect_mission instead
  - `reflect_mission` string, nullable: Mission/context for Reflect operations. Guides how Reflect interprets and uses memories.
  - `retain_mission` string, nullable: Steers what gets extracted during retain(). Injected alongside built-in extraction rules.
  - `retain_extraction_mode` string, nullable: Fact extraction mode: 'concise' (default), 'verbose', 'custom', 'verbatim', or 'chunks'.
  - `retain_custom_instructions` string, nullable: Custom extraction prompt. Only active when retain_extraction_mode is 'custom'.
  - `retain_chunk_size` integer, nullable: Target maximum characters for each content chunk during retain.
  - `retain_structured_chunk_size` integer, nullable: Maximum characters for a single JSONL line or conversation turn to keep whole during retain. Defaults to retain_chunk_size when unset.
  - `retain_max_attachments_per_chunk` integer, nullable: Maximum inline attachments one extraction chunk may carry. retain_chunk_size budgets text only — a placeholder costs the characters it occupies and nothing more — so this is what bounds attachments. Match it to the provider's per-request limit.
  - `enable_observations` boolean, nullable: Toggle automatic observation consolidation after retain().
  - `observations_mission` string, nullable: Controls what gets synthesised into observations. Replaces built-in consolidation rules entirely.
  - `enable_text_search` boolean, nullable: Toggle the keyword (BM25) retrieval arm during recall. Disabling leaves pure vector search: the arm is left out of the query entirely rather than filtered to nothing, so none of its cost is paid. Also drops the keyword arm from knowledge-page search.
  - `enable_temporal_retrieval` boolean, nullable: Toggle the temporal retrieval arm during recall, together with the date-aware query analysis that feeds it. Useful for banks whose content carries no meaningful dates.
  - `enable_graph_retrieval` boolean, nullable: Toggle the entity/link graph traversal arm during recall. Disabling trades relational recall for latency on banks whose content has little entity structure.
  - `enable_reranking` boolean, nullable: Toggle cross-encoder reranking during recall. Disabling returns the RRF-fused ordering directly, which is faster but less precise.

## Response `200`

Successful Response

- BankProfileResponse: Response model for bank profile.
  - `bank_id` string, required
  - `name` string, required
  - `disposition` DispositionTraits, required: Disposition traits that influence how memories are formed and interpreted.
    - `skepticism` integer, required: How skeptical vs trusting (1=trusting, 5=skeptical)
    - `literalism` integer, required: How literally to interpret information (1=flexible, 5=literal)
    - `empathy` integer, required: How much to consider emotional context (1=detached, 5=empathetic)
  - `mission` string, required: The agent's mission - who they are and what they're trying to accomplish
  - `background` string, nullable: Deprecated: use mission instead

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-04** `4fda98b75f63`: 1 warning, 6 info
  - removed the optional property `detail/items/url` from the response with the `422` status
  - added the new optional request property `enable_graph_retrieval`
  - added the new optional request property `enable_reranking`
  - added the new optional request property `enable_temporal_retrieval`
  - …3 more
- **2026-05-15** `0d08f271b9db`: 3 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - added the optional property `detail/items/url` to the response with the `422` status

[Operation history](https://skmtc.dev/vectorize/apis/hindsight-http-api/changes/v1/default/banks/:bank_id/patch.md)

---

[API](https://skmtc.dev/vectorize/apis/hindsight-http-api.md) - [All operations](https://skmtc.dev/vectorize/apis/hindsight-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vectorize/apis/hindsight-http-api/revisions/45e711cd0897?raw)