SmartMemory
POST
/memory/ingest/document

Ingest an HTML document from a public URL.

Creates a parent document node (INDEXED) and chunk nodes (FULL, embedded) linked via PART_OF edges. Deduplicates by source URL + content hash.

Security (SVC-2.0-DOC-HTML-FETCH-1): only http:// and https:// URLs on their default ports are accepted. The route fetches the page itself through DocumentFetcher (every hop resolved once and every answer vetted public, the connection pinned to the vetted address, redirects re-checked hop by hop, size and total time capped) and hands the HTML to core as a string, so no loader fetches by itself. A source over 2,048 characters is the fixed 422 "source URL is not valid." (the fetcher applies the same cap to every redirect hop). Local-file ingestion is exposed via the CLI (CORE-STRUCT-CLI-1). A URL can only carry HTML here: txt, markdown, pdf and docx loaders read local paths (CORE-2.0-DOC-URL-TYPES-1).

Authorization

AuthorizationBearer <token>

Send Authorization: Bearer <token>. The token is either a Clerk session JWT or a SmartMemory API key (prefix sm_live_, sm_test_, or legacy sk_).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/memory/ingest/document" \  -H "Content-Type: application/json" \  -d '{    "source": "string"  }'
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}