Skip to main content
POST
/
memory
Save memory
curl --request POST \
  --url https://www.dench.com/api/v1/memory \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "deployment-policy",
  "kind": "decision",
  "text": "Never deploy without human approval.",
  "tags": [
    "deployment",
    "policy"
  ]
}
'
{
  "ok": true,
  "memoryId": "<string>"
}

Authorizations

​
Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Body

application/json
​
key
string
required

Stable memory key.

​
kind
enum<string>
required

Memory classification.

Available options:
fact,
decision,
preference,
goal,
tool_note,
other,
convention,
project_context,
agent_lesson,
docs_knowledge,
open_goal
​
text
string
required

Memory body. No secrets or scratch notes.

​
tags
string[]
​
sensitivity
enum<string>

Sensitivity tier; sensitive memories land in needs-review.

Available options:
normal,
broad,
sensitive
​
visibility
enum<string>

Who can see the memory. Defaults to user.

Available options:
user,
org
​
projectId
string
​
sourceQuote
string
​
confidence
number
​
importance
number

Response

Successful response

​
ok
boolean
required
​
memoryId
string
required
​
status
enum<string>
required
Available options:
active,
needs_review