Create or update memory bank

PUT /v1/default/banks/{bank_id}

Create a new agent or update existing agent with disposition and mission. Auto-fills missing fields with defaults.

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

Path Parameters

Name	Type	Required	Description
bank_id	string	Yes

Request Body

Content-Type: application/json

{
  "observations_mission": "Observations are stable facts about people and projects. Always include preferences and skills.",
  "retain_mission": "Always include technical decisions and architectural trade-offs. Ignore meeting logistics."
}

Example Request

curl -X PUT 'https://api.hindsight.vectorize.io/v1/default/banks/your-bank-id' \
  -H 'Authorization: Bearer hsk_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "observations_mission": "Observations are stable facts about people and projects. Always include preferences and skills.",
    "retain_mission": "Always include technical decisions and architectural trade-offs. Ignore meeting logistics."
  }'

Responses

200 — Successful Response

{
  "bank_id": "user123",
  "disposition": {
    "empathy": 3,
    "literalism": 3,
    "skepticism": 3
  },
  "mission": "I am a software engineer helping my team stay organized and ship quality code",
  "name": "Alice"
}

422 — Validation Error

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

---

Source: /v1/default/banks/{bank_id}