supermemory/apps/docs/snippets
sohamd22 4347970d16 docs(api): align v5 ingestion and document operations docs with the API (#1810)
Fixes v5 ingestion and document-operation docs.

- **Query params return `400`.** `dreaming`, `fileType` and `mimeType` were documented as query params; they are JSON body or multipart form fields.
- **Errors.** Out-of-balance quota is `402`, not `429`; `429` is only rate limiting. Added the `409` returned during a namespace merge.
- **Statuses.** There is no `processing` status. The real ones are queued, extracting, chunking, embedding, done and failed; treat anything else as in progress.
- **`group` on updates.** `group` is ingestion-side: it picks which existing memories serve as context while content is processed. Changing it only takes effect on re-ingestion, so it's sent with `content`/`file`. The "group-only PATCH" claims are removed from the migration doc.
- **Lists, deletes and forget:**
  - Valid `sort` values per type, a `limit` max of 100, and `include.forgotten`.
  - Deletes skip documents that are still processing.
  - Forget-matching has a 100-match cap and a 2000-character `query` limit.
- **Failed documents stay `failed`.** The docs said they're deleted after 2 minutes. They actually stay `failed`, and resending the same `id` reprocesses them.
- **Smaller fixes:**
  - Metadata allows `string[]`.
  - The batch response field is `count`.
  - `audio` is a valid `fileType`.
  - Chunk overlap is 200 characters.
  - URL extraction no longer claims Markdowner.
  - Search examples no longer index the response object as an array.

Checked against the current API and the published SDKs (TS 5.0.1, Python 5.0.0). Legacy v3/v4 docs are unchanged apart from factual fixes.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
2026-10-15 18:52:40 +00:00
..
agent-prompt-panel.jsx fix docs icons in dark mode (#1735) 2026-09-30 22:00:27 +00:00
agent-prompt.jsx docs: move the home page agent prompt and hero samples to v5 (#1776) 2026-10-06 18:53:19 +00:00
api-v5-agent-prompt.mdx docs: one-line migrate tip on every v5 entry point (#1779) 2026-10-06 21:22:40 +00:00
api-v5-completion.mdx docs: move SDK snippets to the shipped v5 call shape and finish the namespace rename (#1772) 2026-10-06 17:06:38 +00:00
api-v5-content-management.mdx docs(api): align v5 ingestion and document operations docs with the API (#1810) 2026-10-15 18:52:40 +00:00
api-v5-document-ingestion.mdx docs(api): document paginated v5 namespace list (#1769) 2026-10-06 17:23:47 +00:00
api-v5-document-updates.mdx docs(api): align v5 ingestion and document operations docs with the API (#1810) 2026-10-15 18:52:40 +00:00
api-v5-filters.mdx docs(api): move v5 search and ingest options into the request body (#1808) 2026-10-15 18:52:40 +00:00
api-v5-memory-forgetting.mdx docs(api): align v5 ingestion and document operations docs with the API (#1810) 2026-10-15 18:52:40 +00:00
api-v5-namespaces.mdx docs(api): document paginated v5 namespace list (#1769) 2026-10-06 17:23:47 +00:00
api-v5-organization.mdx docs(api): document paginated v5 namespace list (#1769) 2026-10-06 17:23:47 +00:00
api-v5-overview.mdx docs: move SDK snippets to the shipped v5 call shape and finish the namespace rename (#1772) 2026-10-06 17:06:38 +00:00
api-v5-profiles.mdx docs(api): keep the default preferences bucket and drop v4 profile labels in v5 docs (#1809) 2026-10-15 18:52:40 +00:00
api-v5-rollout.mdx docs: move SDK snippets to the shipped v5 call shape and finish the namespace rename (#1772) 2026-10-06 17:06:38 +00:00
api-v5-sdks.mdx docs(api): document v5 system.dreamingStatus (#1797) 2026-10-12 21:56:52 +00:00
api-v5-search.mdx docs: move SDK snippets to the shipped v5 call shape and finish the namespace rename (#1772) 2026-10-06 17:06:38 +00:00
getting-api-key.mdx docs: refresh the documentation design (#1715) 2026-09-29 17:26:13 -07:00
hero-samples.jsx docs: move the home page agent prompt and hero samples to v5 (#1776) 2026-10-06 18:53:19 +00:00
journey.mdx docs: restructure documentation site and update integration UI (#1331) 2026-07-21 20:19:30 -07:00
migrate-cli.mdx docs: one-line migrate tip on every v5 entry point (#1779) 2026-10-06 21:22:40 +00:00
slack-message.mdx fix docs image pipeline (#1411) 2026-08-04 04:55:50 +00:00