Schedule agent-backed thread distillation for a large or deferred thread.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "http://127.0.0.1:14242/memories/distill/schedule" \  -H "Content-Type: application/json" \  -d '{    "thread_id": "string"  }'

{
  "success": true,
  "task_id": "string",
  "scheduled_at": "string",
  "delay_seconds": 0,
  "task_type": "string",
  "thread_id": "string",
  "recommended_execution_mode": "background_agent",
  "message": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Schedule agent-backed thread distillation for a large or deferred thread.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

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.

delay_seconds?Delay Seconds

Delay before the background Knowledge Agent starts the task.

Default5

Range1 <= value <= 300

Response Body

`application/json`

curl -X POST "http://127.0.0.1:14242/memories/distill/schedule" \  -H "Content-Type: application/json" \  -d '{    "thread_id": "string"  }'

{
  "success": true,
  "task_id": "string",
  "scheduled_at": "string",
  "delay_seconds": 0,
  "task_type": "string",
  "thread_id": "string",
  "recommended_execution_mode": "background_agent",
  "message": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Schedule Distillation

Request Body

Response Body

`application/json`

`application/json`

Schedule Distillation

Request Body

Response Body

`application/json`

`application/json`

Schedule Distillation

Request Body

Response Body

200application/json

422application/json

Schedule Distillation

Request Body

Response Body

200application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`