internal

Run food-processor matcher modules (internal testing)

Requires elevated permissions. Exercise matcher components outside the MPQ flow. Minimal body: { "patient_id": 123, "food": "apple" } (defaults to composite_production). Provide either meal_photo_queue_id (full QueueLabelContext) or patient_id. Send modules to override preset (not both). Packaged matcher presets are testable here even though prod packaged MPQs still route through composite MATCH_V2.

post/internal/matcher/match

Request body

brandstring nullable
foodstring required
include_debugboolean

When true, include detailed canonical algorithm debug in results[].debug_info for the canonical module: query_inference (LLM canonical name, ontology, inferred properties), canonical_algorithm_weights, per-candidate score breakdowns (ontology_breakdown, property_breakdown.property_scores), and all ranked candidates.

include_health_contextboolean

When true, include the patient's health/dietary context (diet restrictions, recent meals and meal sizes) in the matcher context, and therefore in the LLM prompt and Langfuse trace. Defaults to false so test runs do not send patient health signals unless explicitly requested. Only applies when patient_id is used.

meal_photo_queue_idinteger nullable

When set, builds QueueLabelContext from this MPQ (same as pipeline).

modulesstring[] nullable

Override preset with explicit module list (send preset or modules, not both).

patient_idinteger nullable

Required when meal_photo_queue_id is omitted.

patient_notestring nullable

Optional patient note override when using patient_id.

preparation_methodstring nullable
preset'composite_matcher' | 'simple_matcher' | 'packaged_matcher' | 'composite_production' | 'composite_batch_production' | 'simple_production' | 'packaged_production' nullable

Matcher pipeline preset. Defaults to composite_production when omitted and modules unset.

Response

successful operation

langfuse_session_idstring required
matcher_modules_requestedstring[] nullable
matcher_modules_resolvedstring[] required
matcher_presetstring nullable
module_order_applied'production' | 'caller' required
modules_executedstring[] required
text_decompobject nullable

Changes

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