memories

Always run this before writing or deleting **personal** memory (always the signed-in person's personal org, regardles...

Always run this before writing or deleting personal memory (always the signed-in person's personal org, regardless of which org this connection uses). Submit the candidate, review related memories, then decide whether to upsert, delete, both, or do nothing. Do not upsert blindly. 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. 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/verify

Request

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

Request body

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).

categorystring

Optional freeform category label for the memory. Suggested examples: preference, identifier, relationship, workflow, project, profile.

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 agent-supplied dedupe key for the memory. Reuse when the agent wants a deterministic durable key.

limitinteger

Maximum related memories to return. Defaults to 5.

conversation_idstring

Optional conversation id used to suppress memories that were already surfaced in the same conversation.

include_suppressed_in_conversationboolean

When true, include memories even if they were already surfaced for the same conversation id.

Response

Success.

recommended_actionsstring[] required

Changes

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