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).
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": {}
}
]
}Ingest Conversation
Ingest a conversation as session chunks, using the full pipeline by default (RLM-1g).
Ingest Launch Event
Record a launch funnel event from a trusted CLI/wrapper caller. Body: ``{event_type: str, props: dict}``. ``user_id`` / ``workspace_id`` are taken from the auth scope, so the body cannot override them.