Memory
AGH Memory HTTP endpoints.
- Audience
- Operators running durable agent work
- Focus
- API Reference guidance shaped for scanability, day-two clarity, and operator context.
List memory document headers
/api/memoryQuery Parameters
Memory scope
"global" | "workspace"Workspace id or path
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://loading/api/memory"[
{
"agent_name": "string",
"description": "string",
"filename": "string",
"mod_time": "2019-08-24T14:15:22Z",
"name": "string",
"type": "user"
}
]{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}Trigger dream consolidation
/api/memory/consolidateRequest Body
application/json
JSON request body
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://loading/api/memory/consolidate" \ -H "Content-Type: application/json" \ -d '{}'{
"reason": "string",
"triggered": true
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}Get memory health
/api/memory/healthQuery Parameters
Workspace id or path
Response Body
application/json
application/json
application/json
curl -X GET "https://loading/api/memory/health"{
"configured": true,
"dream_agent": "string",
"dream_check_interval": "string",
"dream_enabled": true,
"dream_min_hours": 0.1,
"dream_min_sessions": 0,
"enabled": true,
"global_dir": "string",
"global_files": 0,
"indexed_files": 0,
"last_consolidation": "2019-08-24T14:15:22Z",
"last_operation_at": "2019-08-24T14:15:22Z",
"last_reindex": "2019-08-24T14:15:22Z",
"operation_count": 0,
"orphaned_files": 0,
"reason": "string",
"status": "string",
"workspace_count": 0,
"workspace_files": 0
}{
"error": "string"
}{
"error": "string"
}List redacted memory operation history
/api/memory/historyQuery Parameters
Memory scope
"global" | "workspace"Workspace id or path
Memory operation type
Only operations since this timestamp
date-timeMaximum number of operations to return
int32Response Body
application/json
application/json
application/json
curl -X GET "https://loading/api/memory/history"{
"operations": [
{
"agent_name": "string",
"filename": "string",
"id": "string",
"operation": "string",
"scope": "string",
"summary": "string",
"timestamp": "2019-08-24T14:15:22Z",
"workspace": "string"
}
]
}{
"error": "string"
}{
"error": "string"
}Read one memory document
/api/memory/{filename}Path Parameters
Memory filename
Query Parameters
Memory scope
"global" | "workspace"Workspace id or path
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://loading/api/memory/string"{
"content": "string"
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}Delete one memory document
/api/memory/{filename}Path Parameters
Memory filename
Query Parameters
Memory scope
"global" | "workspace"Workspace id or path
Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://loading/api/memory/string"{
"ok": true
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}Write one memory document
/api/memory/{filename}Path Parameters
Memory filename
Request Body
application/json
JSON request body
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X PUT "https://loading/api/memory/string" \ -H "Content-Type: application/json" \ -d '{ "content": "string" }'{
"ok": true
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}