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.
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/launch/event" \ -H "Content-Type: application/json" \ -d '{}'null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}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).
Install Adapter
Connect an integration: body ``{credential: {kind: pasted, value} | {kind: onepassword, ref} | {kind: none}, config?: {...}}``. The body is validated by hand (not a pydantic body model) so a refused token never comes back in a 422.