---
id: create-or-update-bank
title: "Create or update memory bank"
description: "Create a new agent or update existing agent with disposition and background. Auto-fills missing fields with defaults."
sidebar_label: "Create or update memory bank"
hide_title: true
hide_table_of_contents: true
api: eJztV01v2zgQ/SvEnBpA8Ve2FwE9JGmABki7QZLuJQgCWhpJbChSJSl/QPB/XwwpW1IcZ7PBArsL1BfL5Az55unNo9lAijYxonJCK4jh3CB3yDhTuGQ8R+WYNqyuUhrFlbBOqLydWApXsFTYSltB6YyrlM158pQbXat0xE5rp48zIaVlpbCWMjOBMrVtKma8ls6OIAJdoeG0yGUKMSQexaM2j2HnxzlXTxBBxQ0v0aGxEN83oHiJEANNPooUIhBUQsVdAREY/FkLgynEztQYgU0KLDnEDbh1RWnWGaFyiMAJJ2ngjKsndpnCZvMQ0tG6M52uKef5aolWDpWjKV5VUiQe/PiHJRab3maVodKcQEu/AuIGuFr/nvkahmA20W5E1VICIdnC+0a5mwh6jA+XGm5ln7ByIhG27NUslMMcDURQ8pUo6xLijxGUQoXnabfbbZcePdPIF71k7epcsoVlztRBFx+mn7bPEfv4aRd0RLilcGi4fC+gqy79JUDt6nLNnGa0qqkMOiZUpk3pXw6hyySuxFwioWszPDYsSTXrdwG7aHNfQlXWSUGAEq2sSNEwLDVNc8m8glaOUKXoeFJgSqgCEnQiOYLNJtrC0fMfmLiBrO/7r3hAb1dPTz6fO9ncGS6c3QPci2DOhzBXcM+hrFElyAoqCUttBFrGDTIiF1Pf+DvOMaWGxhUvK+nFviP3ZCiCk2gg0pPNvvo3EXSG8t7GOetWeInRbViwPjKBm9D7ewS146zUKUqqnXmjEiofe5/y1sjIjp4x0K8BLhkvGW9TF8isztySyESVC4VogjtOJ2yN3FimM4arCo2gVwB7/f9mdqOtX55KkSBs6EN6spVWNnjGbDKhr2HVt3WSoLVZLdlNGwzvNsCtV7/FhqOdXR4KPWCJv4zwlxH+z43wme0d7pVXra3PUfcvyXfVsGkG+z0Me/Ha6ExI7PX+c1cMEz1bpL1YFfLeYIV/ywGZUMw6blxdWY+7NRSoLZrp7OQfd8jfZrN9U/yDS5GGbrowRpv3OyJpXkh6Eg5Lux8gdTKYfcMRuO1Zf4C2Y9wYvu5J50oHgNT1pc1fU9lXtJbn3mlDyOFQTwa7o9m/EiTVFbZu43q66+gN7B4u43Og77WD/cvd3fXeguHdlugKTeKpaufvF66AGMaL6bi9nIxJX3bctDLbQAT0Qm+628HFf/yYp1tRpv072/IhVGpFXjhGzLDT68t9y24nfDfv4luR88R1dxn4Sja4Zrdr67AMx1uC5BNdyGlFrs5mowlEUBsJMRTOVTYej5fL5Yj76ZE2+bjNteOry/OLb7cXx7PRZFS4UtLCCzQ2wJuOJqMJDVXaupKr3l7tBba7tJYBX3uDHJTZdD37r118W9HSCTiuJBe+Hz1HTSvHe1hMPXKf1FoeWV+89b6HCAptHYU2zZxb/G7kZkPDP2s0a4jvHyJYcCP4nARw35C46DmFOOPS4iu8fLhpW/aIHUK77UxFfbngsqZfEMETrnu3c+9FBfIUjYcQZs/DRsfeMbrsPQMlcwsZp0mClXs19qHX2Nff74iy9hpPRxTEYPiSzIgvA1Dt6/bm6scakFzlNVleDGFJ+vwJ2q/ySQ==
sidebar_class_name: "put api-method"
info_path: docs/api-reference/endpoints/hindsight-http-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create or update memory bank"}
>
</Heading>

<MethodEndpoint
  method={"put"}
  path={"/v1/default/banks/{bank_id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



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

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"name":"bank_id","in":"path","required":true,"schema":{"type":"string","title":"Bank Id"}}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"disposition":{"anyOf":[{"properties":{"skepticism":{"type":"integer","maximum":5,"minimum":1,"title":"Skepticism","description":"How skeptical vs trusting (1=trusting, 5=skeptical)"},"literalism":{"type":"integer","maximum":5,"minimum":1,"title":"Literalism","description":"How literally to interpret information (1=flexible, 5=literal)"},"empathy":{"type":"integer","maximum":5,"minimum":1,"title":"Empathy","description":"How much to consider emotional context (1=detached, 5=empathetic)"}},"type":"object","required":["skepticism","literalism","empathy"],"title":"DispositionTraits","description":"Disposition traits that influence how memories are formed and interpreted.","example":{"empathy":3,"literalism":3,"skepticism":3}},{"type":"null"}]},"background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Background"}},"type":"object","title":"CreateBankRequest","description":"Request model for creating/updating a bank.","example":{"background":"I am a creative software engineer with 10 years of experience","disposition":{"empathy":3,"literalism":3,"skepticism":3},"name":"Alice"}}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"bank_id":{"type":"string","title":"Bank Id"},"name":{"type":"string","title":"Name"},"disposition":{"properties":{"skepticism":{"type":"integer","maximum":5,"minimum":1,"title":"Skepticism","description":"How skeptical vs trusting (1=trusting, 5=skeptical)"},"literalism":{"type":"integer","maximum":5,"minimum":1,"title":"Literalism","description":"How literally to interpret information (1=flexible, 5=literal)"},"empathy":{"type":"integer","maximum":5,"minimum":1,"title":"Empathy","description":"How much to consider emotional context (1=detached, 5=empathetic)"}},"type":"object","required":["skepticism","literalism","empathy"],"title":"DispositionTraits","description":"Disposition traits that influence how memories are formed and interpreted.","example":{"empathy":3,"literalism":3,"skepticism":3}},"background":{"type":"string","title":"Background"}},"type":"object","required":["bank_id","name","disposition","background"],"title":"BankProfileResponse","description":"Response model for bank profile.","example":{"background":"I am a software engineer with 10 years of experience in startups","bank_id":"user123","disposition":{"empathy":3,"literalism":3,"skepticism":3},"name":"Alice"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}}}}
>
  
</StatusCodes>