Create memories from a conversation thread.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request for memory distillation from thread content.

thread_id*Thread Id

Source thread ID

thread_title?|

Thread title for context

thread_content?|

Full thread content to distill. Optional when thread_id refers to a stored thread.

distillation_type?Distillation Type

Type: 'simple_llm' or 'knowledge_graph'

Default"simple_llm"

extraction_level?Extraction Level

Extraction level: 'swift' (fast, local), 'guided' (multi-step, local), or 'expert' (remote LLM). Auto-upgrades to expert when local LLM is unavailable.

Default"swift"

cache_key?|

Cache key from preview to reuse results

selected_message_indices?array<integer>|

Optional list of message indices to process; if omitted, process full thread

preferred_language?|

User preferred output language (ISO 639-1 code, e.g. 'en', 'zh', 'ja'), or None to follow input language

force_distill?Force Distill

When true, bypass the strict worthiness gate because the user explicitly requested distillation

Defaultfalse

space_id?|

Optional isolation space guard for the source thread.

existing_memories?array<>|

Optional compact existing memories for preview-time Memory-to-Memory relation proposals.

native_source_operation?

Explicit scheduled native source-derived Thread operation. Recorded roles and source references do not authenticate humans or establish adoption. The host restores the original scheduled task funding and assesses each exact candidate before publication. Authored intent, inline transcript overrides, conflicting selectors and foreign/unreadable Space are rejected. Omit the field for unchanged deterministic distillation. No caller root, grant, provider or cancellation authority is accepted.

Response Body

`application/json`

curl -X POST "https://example.com/memories/distill" \  -H "Content-Type: application/json" \  -d '{    "thread_id": "string"  }'

{  "memory": {    "id": "string",    "node_type": "Thread",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z",    "metadata": {},    "content": "string",    "title": "string",    "importance": 0.5,    "confidence": 0.5,    "pagerank_score": 0,    "embedding": [      0    ],    "source_range": {      "property1": 0,      "property2": 0    },    "source": "string",    "space_id": "default",    "semantic_field": "string",    "reindex_needed": false,    "last_reindexed_at": "2019-08-24T14:15:22Z",    "last_accessed_at": "2019-08-24T14:15:22Z",    "access_count": 0,    "appearances": 0,    "clicks": 0,    "total_dwell_time_ms": 0,    "last_clicked_at": "2019-08-24T14:15:22Z",    "decay_score_cached": 1,    "temporal_context": "timeless",    "temporal_type": "string",    "event_start": "string",    "event_end": "string",    "temporal_precision": "string",    "temporal_confidence": 0,    "unit_type": "fact",    "is_latest": true,    "version": 1,    "is_crystal": false,    "crystal_title": "string",    "source_unit_count": 0,    "extraction_method": "manual",    "last_evaluated_at": "2019-08-24T14:15:22Z",    "review_status": ""  },  "extracted_entities": [    {      "id": "string",      "node_type": "Thread",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "metadata": {},      "name": "string",      "entity_type": "string",      "description": "string",      "aliases": [        "string"      ],      "confidence": 0.5,      "entity_created": "string",      "entity_ended": "string",      "temporal_precision": "string",      "temporal_confidence": 0,      "temporal_context": "string"    }  ],  "assigned_labels": [    "string"  ],  "created_relationships": 0,  "action": "created",  "warnings": [    "string"  ]}

Distill Memories From Thread

Request Body

Response Body

200application/json

422application/json

`application/json`

`application/json`