From a0b059a886af2ea1511166fd37d454f0e7428246 Mon Sep 17 00:00:00 2001 From: Soham Daga Date: Mon, 5 Oct 2026 16:12:03 -0700 Subject: [PATCH] docs(api): document 202 for v5 async ingest --- apps/docs/snippets/api-v5-document-ingestion.mdx | 2 +- apps/docs/snippets/api-v5-document-updates.mdx | 2 +- apps/docs/snippets/api-v5-rollout.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/apps/docs/snippets/api-v5-document-ingestion.mdx b/apps/docs/snippets/api-v5-document-ingestion.mdx index 79a9e731..d004a783 100644 --- a/apps/docs/snippets/api-v5-document-ingestion.mdx +++ b/apps/docs/snippets/api-v5-document-ingestion.mdx @@ -25,7 +25,7 @@ POST /ns/user_1/document?dreaming=dynamic ``` -The response remains an acceptance result with `id` and `status`. Repeating the v5 request with `id: "conv_1"` adds or diffs the new content into that document; it does not silently replace the canonical source. +The response remains an acceptance result with `id` and `status`, now returned as `202 Accepted` instead of `200`. Repeating the v5 request with `id: "conv_1"` adds or diffs the new content into that document; it does not silently replace the canonical source. ### Batch ingestion diff --git a/apps/docs/snippets/api-v5-document-updates.mdx b/apps/docs/snippets/api-v5-document-updates.mdx index 5f9a3192..0b24d8f6 100644 --- a/apps/docs/snippets/api-v5-document-updates.mdx +++ b/apps/docs/snippets/api-v5-document-updates.mdx @@ -59,7 +59,7 @@ The path `id` may be the Supermemory document ID or your caller-defined ID. It i ### Processing and conflicts -Content or file replacement is accepted before downstream processing completes. A document still processing, a namespace conflict, or a conflicting internal file path can return `409`; retry only after the conflicting operation reaches a terminal state. +Content or file replacement returns `202 Accepted` before downstream processing completes. A document still processing, a namespace conflict, or a conflicting internal file path can return `409`; retry only after the conflicting operation reaches a terminal state. ### Verification diff --git a/apps/docs/snippets/api-v5-rollout.mdx b/apps/docs/snippets/api-v5-rollout.mdx index bf468250..30995662 100644 --- a/apps/docs/snippets/api-v5-rollout.mdx +++ b/apps/docs/snippets/api-v5-rollout.mdx @@ -11,7 +11,7 @@ Record each legacy request, v5 request, expected semantic result, and intentiona - Repeated POST appends or diffs; PATCH replaces canonical content. - Batch outcomes preserve input order and surface partial failures. - Metadata-only updates leave source content unchanged. -- Accepted writes are polled until processing reaches a terminal state. +- Accepted writes return `202` and are polled until processing reaches a terminal state. ### Compare reads and recall