Import conversations idempotently
Import one conversation with the flat request fields, or use threads for a batch. Each item accepts parsed messages or conversation markdown_content. Provider and frontmatter identities are preserved; otherwise a stable identity is derived from the immutable conversation prefix. Exact replays succeed as already up to date, while later exports append only missing messages. See the Conversation Markdown format for portable .md files.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Import one or more conversation threads (schemas.ThreadImportRequest,
threads_module/schemas.py:490-525). Single mode sets the flat fields;
batch mode uses threads.
Response Body
application/json
application/json
curl -X POST "https://example.com/threads/import" \ -H "Content-Type: application/json" \ -d '{}'{ "auto_review": null, "failed_count": 0, "imported_count": 0, "results": [ { "already_existed": true, "error": "string", "message_count": 0, "messages_added": 0, "success": true, "thread_id": "string", "title": "string" } ], "skipped_count": 0, "success": true}Empty
{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}