curl -X POST "https://api.danubeai.com/v1/context/personal/upsert" \
-H "danube-api-key: YOUR_DANUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "notes.md",
"content": "Prefers weekly summaries on Mondays.",
"mode": "append"
}'
from danube import DanubeClient
with DanubeClient(api_key="YOUR_DANUBE_API_KEY") as client:
doc = client.context.remember("Prefers weekly summaries on Mondays.")
print(doc.version)
danube context remember "Prefers weekly summaries on Mondays."
{
"id": "77aa...",
"name": "notes.md",
"content": "I lead the support team.\n\nPrefers weekly summaries on Mondays.",
"version": 3,
"position": 0,
"updated_at": "2026-09-27T10:15:00Z",
"updated_via": "api",
"updated_by": "a8e1...",
"created": false
}
Context
Upsert Personal Context
Write one of your personal context documents by name, creating it when missing
POST
/
v1
/
context
/
personal
/
upsert
curl -X POST "https://api.danubeai.com/v1/context/personal/upsert" \
-H "danube-api-key: YOUR_DANUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "notes.md",
"content": "Prefers weekly summaries on Mondays.",
"mode": "append"
}'
from danube import DanubeClient
with DanubeClient(api_key="YOUR_DANUBE_API_KEY") as client:
doc = client.context.remember("Prefers weekly summaries on Mondays.")
print(doc.version)
danube context remember "Prefers weekly summaries on Mondays."
{
"id": "77aa...",
"name": "notes.md",
"content": "I lead the support team.\n\nPrefers weekly summaries on Mondays.",
"version": 3,
"position": 0,
"updated_at": "2026-09-27T10:15:00Z",
"updated_via": "api",
"updated_by": "a8e1...",
"created": false
}
Overview
Creates or changes the caller’s personal context document calledname. This is what an agent calls to remember something about you (the MCP update_context tool uses it). Every change keeps the previous text as a revision, which you can see and restore in Dashboard > Context.
Organization context can’t be written here. Organization documents are edited by the organization’s owners and admins in the dashboard; /v1/organizations/{org_id}/context/documents answers 403 to any API key, an admin’s included.
Auth: API key (danube-api-key header) or dashboard session (JWT). An agent writing on your behalf sends x-danube-via: agent so the revision is labeled as the agent’s; SDKs and scripts leave it off.
Body Parameters
string
required
Document name: 1 to 80 letters, digits, spaces, dots, dashes or underscores.
.md is added when there is no extension.string
required
Markdown. At most 32,000 characters per document. Content that contains a credential (an API key, token or private key) is refused with
400; store secrets as a credential instead.string
default:"replace"
replace overwrites the document; append adds content as a new paragraph at the endinteger
The version you read. If the document changed since then, nothing is written and the answer is
409 with the current document in detail.current.Response
The document after the write:id, name, content, version, position, updated_at, updated_via, updated_by, plus created (true when the document did not exist before).
Limits
- 10 documents per layer; a new document past that answers
400. - 32,000 characters per document, after an append too.
Example
curl -X POST "https://api.danubeai.com/v1/context/personal/upsert" \
-H "danube-api-key: YOUR_DANUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "notes.md",
"content": "Prefers weekly summaries on Mondays.",
"mode": "append"
}'
from danube import DanubeClient
with DanubeClient(api_key="YOUR_DANUBE_API_KEY") as client:
doc = client.context.remember("Prefers weekly summaries on Mondays.")
print(doc.version)
danube context remember "Prefers weekly summaries on Mondays."
{
"id": "77aa...",
"name": "notes.md",
"content": "I lead the support team.\n\nPrefers weekly summaries on Mondays.",
"version": 3,
"position": 0,
"updated_at": "2026-09-27T10:15:00Z",
"updated_via": "api",
"updated_by": "a8e1...",
"created": false
}
Related endpoints
| Endpoint | Purpose |
|---|---|
POST /v1/context/personal/documents | Create a document (name, content) |
PUT /v1/context/personal/documents/{id} | Change name, content or position, with expected_version |
DELETE /v1/context/personal/documents/{id} | Delete a document |
GET /v1/context/personal/documents/{id}/revisions | List earlier versions |
POST /v1/context/personal/documents/{id}/revisions/{revision_id}/restore | Restore one (the restore is itself a new version) |
PUT /v1/context/timezone | Set your IANA timezone ({"timezone": "Europe/Oslo"}, or null to clear) |
GET /v1/organizations/{org_id}/context/documents | Read the organization’s documents (any member) |