memories

Create or update a **personal** memory for the signed-in person (always their personal org, regardless of which org t...

Create or update a personal memory for the signed-in person (always their personal org, regardless of which org this connection uses). Agents must run metaMemoryVerify first. Do not blindly write durable memory without verification. Do not copy a personal memory into an org package without asking the person first. Shared org knowledge belongs in documented packages and org instructions, not memory. If the candidate is really package- or export-scoped guidance, update package docs or JSDoc instead (see search({ entity: "guide:agent_guidance" })).

Org permission: none (touches no org data).

post/v1/memories

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/memories
  • Auth: HTTP bearer

Request body

memory_idstring

Optional existing memory id to update. Omit this field to create a new memory record.

categorystring

Optional freeform category string. Suggested examples include preference, profile, workflow, relationship, or identifier.

subjectstring required

Short durable subject line for the memory record (max 200 characters).

summarystring required

Compact durable summary of the memory (max 500 characters).

detailsstring

Optional supporting details for the durable memory record (max 2000 characters).

tagsstring[]

Optional short tags for retrieval and filtering.

source_urisstring[]

Optional canonical source document URLs for the memory. Treat these as opaque references.

dedupe_keystring

Optional stable dedupe key supplied by the agent.

status'active' | 'archived'

Optional non-deleted status for the memory. Defaults to active.

verified_by_agentboolean required

Must be true when writing memory. Agents must run metaMemoryVerify first and then decide whether to upsert.

verification_referencestring

Optional agent-supplied note, run id, or verification reference describing the verify step that preceded this upsert.

Response

Success.

mode'created' | 'updated' required
warningsstring[] required

Changes

No recorded changes to this operation across all 2 revisions of this API.