API Reference
Write a memory
POST /api/v1/memories — persist content for later recall.
Authorization
APIKeyHeader X-API-Key<token>
In: header
Header Parameters
Idempotency-Key?string|null
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://loading/api/v1/memories" \ -H "Content-Type: application/json" \ -d '{ "tenant_id": "string", "agent_id": "string", "content": "string" }'{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"tenant_id": "string",
"fleet_id": "string",
"agent_id": "string",
"memory_type": "string",
"title": "string",
"content": "string",
"weight": 0,
"source_uri": "string",
"run_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"expires_at": "2019-08-24T14:15:22Z",
"entity_links": [],
"similarity": 0,
"subject_entity_id": "2f43e1a1-7cec-4ccf-9421-4ab19090ca45",
"predicate": "string",
"object_value": "string",
"ts_valid_start": "2019-08-24T14:15:22Z",
"ts_valid_end": "2019-08-24T14:15:22Z",
"status": "active",
"visibility": "scope_team",
"recall_count": 0,
"last_recalled_at": "2019-08-24T14:15:22Z",
"supersedes_id": "8149cd94-4e90-4a99-91f5-a3e0f9b829dc",
"superseded_by": [
{
"old_memory_id": "07606bd2-b9bc-468a-8200-790e8b7345cf",
"old_status": "string",
"reason": "string",
"old_content_preview": "string"
}
],
"usage": {
"memories_stored": 0,
"memories_limit": 0,
"writes_remaining": 0
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}