Ingestion Pipeline

Ingest Preference

Ingest explicit user preferences via the ingestion pipeline.

Optional scope ("<kind>:<value>") is pre-checked against the caller's visible scopes (403 with explanatory body otherwise) and forwarded to the pipeline as write_scope. The ingestion service stamps it on the engine write end to end: PreferenceIngestRequest.write_scope -> _process_preference_pipeline -> ingest_knowledge_graph(write_scope=...) -> the X-Scope-Id header of /etl/ingest-kg. Omitted: the default personal stamp (user:<user_id>).

post/ingestion/preference

Request

Base URL
https://api.getmetacognition.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/metacognition/apis/tex-api/docs/ingestion/preference/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

org_idstring required

Organization identifier

user_idstring required

User identifier

session_idstring nullable

Session identifier

scopestring nullable

Optional explicit write scope "<kind>:<value>" (kinds: user/team/org/project). Must be within the caller's visible scopes; defaults to user:<user_id>.

Response

Successful Response

job_idstring required

Job identifier

statusstring required

Job status

preferences_countinteger required

Number of preferences

estimated_timeinteger nullable

Estimated time in seconds

messagestring nullable

Status message

Changes

No recorded changes to this operation across all 1 revision of this API.

Ingest Preference

Request

Request body

Response 200OK

Changes

Response