ShotPulled

{'type': 'object', 'required': ['bean_id'], 'properties': {'bag_id': {'type': ['integer', 'null'], 'description': "A bag of that coffee (from list_beans' bags[]); null = its current bag"}, 'bean_id': {'type': 'integer'}}}

{'type': 'object', 'required': ['bean_id', 'bag_id', 'roast_date', 'age_days', 'days_off_roast', 'days_since_opened', 'frozen_days_excluded', 'effective_age_days', 'rest_window', 'verdict', 'grams_remaining', 'warnings'], 'properties': {'bag_id': {'type': 'integer'}, 'bean_id': {'type': 'integer'}, 'verdict': {'type': 'string'}, 'age_days': {'type': 'integer'}, 'warnings': {'type': 'array'}, 'roast_date': {'type': 'string'}, 'rest_window': {'type': 'string'}, 'days_off_roast': {'type': 'integer'}, 'grams_remaining': {}, 'days_since_opened': {}, 'effective_age_days': {'type': 'integer'}, 'frozen_days_excluded': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['shot_id'], 'properties': {'shot_id': {'type': 'integer', 'description': 'ID of the shot to delete'}}}

{'type': 'object', 'required': ['status', 'deleted_shot_id', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'deleted_shot_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'dose_g': {'type': 'number', 'description': 'Dose in grams'}, 'source': {'enum': ['measured', 'recalled', 'assumed'], 'type': 'string', 'description': 'Grinder position source — affects G1 warning (raw mode only)'}, 'time_s': {'type': 'number', 'description': 'Extraction time in seconds'}, 'bean_id': {'type': 'integer', 'description': 'Coffee bean ID (must belong to this account)'}, 'shot_id': {'type': 'integer', 'description': 'Preview a logged shot by ID (dry-run; ignores the metric params below)'}, 'yield_g': {'type': 'number', 'description': 'Yield in grams'}, 'grinder_id': {'type': 'integer', 'description': 'Grinder ID (must belong to this account)'}, 'machine_id': {'type': 'integer', 'description': 'Machine ID (must belong to this account)'}, 'grind_label': {'type': 'string', 'description': 'Grinder setting label, e.g. "1.1.3"'}, 'sensory_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Sensory observations, e.g. ["sour","bitter"]. With shot_id: replaces the stored tags for this preview (omit to use stored; [] = none).'}}}

{'type': 'object', 'required': ['category', 'facts', 'hypotheses', 'warnings', 'one_variable_only', 'kb_version', 'bean_context'], 'properties': {'facts': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'source'], 'properties': {'text': {'type': 'string'}, 'source': {'type': 'string'}}, 'additionalProperties': True}}, 'category': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'hypotheses': {'type': 'array', 'items': {'type': 'object', 'required': ['cause', 'lever', 'direction', 'confidence', 'experiment', 'cited_rules'], 'properties': {'cause': {'type': 'string'}, 'lever': {'type': 'string'}, 'direction': {'type': 'string'}, 'confidence': {'type': 'string'}, 'experiment': {'type': 'string'}, 'cited_rules': {'type': 'array', 'items': {'type': 'string'}}, 'target_label': {'type': 'string'}}, 'additionalProperties': True}}, 'kb_version': {'type': 'string'}, 'bean_context': {'type': 'object', 'required': ['bean_id', 'bag_id', 'bean_name', 'roast_level', 'effective_age_days', 'dial_category'], 'properties': {'bag_id': {'type': 'integer'}, 'bean_id': {'type': 'integer'}, 'bean_name': {'type': 'string'}, 'roast_level': {'type': 'string'}, 'dial_category': {'type': 'string'}, 'effective_age_days': {'type': 'integer'}}, 'additionalProperties': True}, 'one_variable_only': {'type': 'boolean'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'shot_id': {'type': 'integer', 'description': 'Optional shot ID; defaults to last pulled shot.'}}}

{'type': 'object', 'required': ['category', 'facts', 'hypotheses', 'warnings', 'one_variable_only', 'kb_version', 'bean_context'], 'properties': {'facts': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'source'], 'properties': {'text': {'type': 'string'}, 'source': {'type': 'string'}}, 'additionalProperties': True}}, 'category': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'hypotheses': {'type': 'array', 'items': {'type': 'object', 'required': ['cause', 'lever', 'direction', 'confidence', 'experiment', 'cited_rules'], 'properties': {'cause': {'type': 'string'}, 'lever': {'type': 'string'}, 'direction': {'type': 'string'}, 'confidence': {'type': 'string'}, 'experiment': {'type': 'string'}, 'cited_rules': {'type': 'array', 'items': {'type': 'string'}}, 'target_label': {'type': 'string'}}, 'additionalProperties': True}}, 'kb_version': {'type': 'string'}, 'bean_context': {'type': 'object', 'required': ['bean_id', 'bag_id', 'bean_name', 'roast_level', 'effective_age_days', 'dial_category'], 'properties': {'bag_id': {'type': 'integer'}, 'bean_id': {'type': 'integer'}, 'bean_name': {'type': 'string'}, 'roast_level': {'type': 'string'}, 'dial_category': {'type': 'string'}, 'effective_age_days': {'type': 'integer'}}, 'additionalProperties': True}, 'one_variable_only': {'type': 'boolean'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['active_coffee', 'active_grinder', 'active_machine', 'active_program', 'recent_shots', 'recent_recommendations', 'locked_recipe', 'maintenance_summary'], 'properties': {'recent_shots': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'pulled_at', 'bean_id', 'grinder_id', 'machine_id', 'program_id', 'grind_label', 'grind_components', 'grind_position_value', 'dose_g', 'yield_g', 'time_s', 'flow_rate_gps', 'finish_action', 'drink_intent', 'flavor_notes', 'sensory_tags', 'observations', 'temp_taste', 'rating', 'verdict', 'data_confidence', 'temperature_c', 'bloom_time_s', 'first_drip_time_s', 'beverage_g', 'tds', 'ey_pct', 'water_id', 'vessel_name', 'vessel_weight_g', 'favourite', 'best_brew', 'tasted', 'bag_id', 'taste_pending'], 'properties': {'id': {'type': 'integer'}, 'tds': {}, 'bag_id': {'type': 'integer'}, 'dose_g': {'type': 'integer'}, 'ey_pct': {}, 'rating': {}, 'tasted': {'type': 'integer'}, 'time_s': {'type': 'integer'}, 'bean_id': {'type': 'integer'}, 'verdict': {}, 'yield_g': {'type': 'integer'}, 'water_id': {}, 'best_brew': {'type': 'integer'}, 'favourite': {'type': 'integer'}, 'pulled_at': {'type': 'string'}, 'beverage_g': {}, 'grinder_id': {'type': 'integer'}, 'machine_id': {'type': 'integer'}, 'program_id': {}, 'temp_taste': {'type': 'string'}, 'grind_label': {'type': 'string'}, 'vessel_name': {}, 'bloom_time_s': {}, 'drink_intent': {'type': 'string'}, 'flavor_notes': {'type': 'string'}, 'observations': {'type': 'string'}, 'sensory_tags': {'type': 'string'}, 'finish_action': {'type': 'string'}, 'flow_rate_gps': {'type': 'number'}, 'taste_pending': {'type': 'integer'}, 'temperature_c': {}, 'data_confidence': {'type': 'string'}, 'vessel_weight_g': {}, 'grind_components': {'type': 'string'}, 'first_drip_time_s': {}, 'grind_position_value': {'type': 'integer'}}, 'additionalProperties': True}}, 'active_coffee': {'type': 'object', 'required': ['id', 'name', 'roaster', 'origin', 'variety', 'roast_date', 'roast_level', 'process_type', 'dial_category', 'bag_notes', 'rest_window_days_min', 'rest_window_days_max', 'state', 'opened_date', 'storage', 'is_active', 'weight_adjustment_g', 'buy_date', 'bag_weight_g', 'cost', 'currency', 'decaffeinated', 'bean_mix', 'roast_range', 'roast_custom', 'roasting_type', 'aromatics', 'cupping_points', 'rating', 'favourite', 'url', 'ean', 'qr_code', 'co2e_kg', 'attachments', 'archived', 'frozen_at', 'unfrozen_at', 'frozen_storage', 'frozen_note', 'best_by_date', 'finished', 'notes', 'arabica_pct', 'body', 'acidity', 'sweetness', 'age_days', 'days_off_roast', 'days_since_opened', 'frozen_days_excluded', 'effective_age_days', 'age_verdict', 'grams_remaining', 'current_bag_id', 'bag'], 'properties': {'id': {'type': 'integer'}, 'bag': {'type': 'object', 'required': ['id', 'bean_id', 'roast_date', 'buy_date', 'opened_date', 'best_by_date', 'bag_weight_g', 'weight_adjustment_g', 'cost', 'currency', 'state', 'finished', 'frozen_at', 'unfrozen_at', 'frozen_storage', 'frozen_note', 'storage', 'ean', 'qr_code', 'bag_notes', 'archived', 'days_off_roast', 'days_since_opened', 'frozen_days_excluded', 'effective_age_days', 'age_verdict', 'grams_remaining'], 'properties': {'id': {'type': 'integer'}, 'ean': {}, 'cost': {}, 'state': {'type': 'string'}, 'bean_id': {'type': 'integer'}, 'qr_code': {}, 'storage': {}, 'archived': {'type': 'integer'}, 'buy_date': {}, 'currency': {}, 'finished': {'type': 'integer'}, 'bag_notes': {'type': 'string'}, 'frozen_at': {}, 'roast_date': {'type': 'string'}, 'age_verdict': {'type': 'string'}, 'frozen_note': {}, 'opened_date': {}, 'unfrozen_at': {}, 'bag_weight_g': {}, 'best_by_date': {}, 'days_off_roast': {'type': 'integer'}, 'frozen_storage': {}, 'grams_remaining': {}, 'days_since_opened': {}, 'effective_age_days': {'type': 'integer'}, 'weight_adjustment_g': {'type': 'integer'}, 'frozen_days_excluded': {'type': 'integer'}}, 'additionalProperties': True}, 'ean': {}, 'url': {}, 'body': {}, 'cost': {}, 'name': {'type': 'string'}, 'notes': {}, 'state': {'type': 'string'}, 'origin': {}, 'rating': {}, 'acidity': {}, 'co2e_kg': {}, 'qr_code': {}, 'roaster': {'type': 'string'}, 'storage': {}, 'variety': {}, 'age_days': {'type': 'integer'}, 'archived': {'type': 'integer'}, 'bean_mix': {}, 'buy_date': {}, 'currency': {}, 'finished': {'type': 'integer'}, 'aromatics': {}, 'bag_notes': {'type': 'string'}, 'favourite': {}, 'frozen_at': {}, 'is_active': {'type': 'integer'}, 'sweetness': {}, 'roast_date': {'type': 'string'}, 'age_verdict': {'type': 'string'}, 'arabica_pct': {}, 'attachments': {}, 'frozen_note': {}, 'opened_date': {}, 'roast_level': {'type': 'string'}, 'roast_range': {}, 'unfrozen_at': {}, 'bag_weight_g': {}, 'best_by_date': {}, 'process_type': {'type': 'string'}, 'roast_custom': {}, 'decaffeinated': {}, 'dial_category': {'type': 'string'}, 'roasting_type': {}, 'cupping_points': {}, 'current_bag_id': {'type': 'integer'}, 'days_off_roast': {'type': 'integer'}, 'frozen_storage': {}, 'grams_remaining': {}, 'days_since_opened': {}, 'effective_age_days': {'type': 'integer'}, 'weight_adjustment_g': {'type': 'integer'}, 'frozen_days_excluded': {'type': 'integer'}, 'rest_window_days_max': {}, 'rest_window_days_min': {}}, 'additionalProperties': True}, 'locked_recipe': {'type': 'object', 'required': ['id', 'bean_id', 'grinder_id', 'machine_id', 'program_id', 'status', 'grind_label', 'grind_position_value', 'dose_g', 'target_yield_g', 'target_time_s', 'finish_action', 'drink_intent', 'profile', 'kb_version', 'locked_at', 'grind_reading'], 'properties': {'id': {'type': 'integer'}, 'dose_g': {'type': 'integer'}, 'status': {'type': 'string'}, 'bean_id': {'type': 'integer'}, 'profile': {'type': 'string'}, 'locked_at': {'type': 'string'}, 'grinder_id': {'type': 'integer'}, 'kb_version': {'type': 'string'}, 'machine_id': {'type': 'integer'}, 'program_id': {}, 'grind_label': {'type': 'string'}, 'drink_intent': {'type': 'string'}, 'finish_action': {'type': 'string'}, 'grind_reading': {}, 'target_time_s': {'type': 'integer'}, 'target_yield_g': {'type': 'integer'}, 'grind_position_value': {'type': 'integer'}}, 'additionalProperties': True}, 'active_grinder': {'type': 'object', 'required': ['id', 'name', 'motor_type', 'burr_type', 'setting_scheme', 'direction_convention', 'nominal_step', 'components_spec', 'min_value', 'max_value', 'microns_per_step', 'notes', 'is_active', 'archived', 'photo', 'catalog_id', 'setting_label', 'setting_components', 'position_value', 'source', 'verified_at', 'built_in_machine_id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': 'string'}, 'notes': {}, 'photo': {}, 'source': {'type': 'string'}, 'archived': {'type': 'integer'}, 'burr_type': {'type': 'string'}, 'is_active': {'type': 'integer'}, 'max_value': {}, 'min_value': {}, 'catalog_id': {}, 'motor_type': {'type': 'string'}, 'verified_at': {'type': 'string'}, 'nominal_step': {'type': 'integer'}, 'setting_label': {'type': 'string'}, 'position_value': {'type': 'integer'}, 'setting_scheme': {'type': 'string'}, 'components_spec': {'type': 'string'}, 'microns_per_step': {'type': 'integer'}, 'setting_components': {'type': 'string'}, 'built_in_machine_id': {}, 'direction_convention': {'type': 'string'}}, 'additionalProperties': True}, 'active_machine': {'type': 'object', 'required': ['id', 'name', 'control_type', 'basket_size_grams', 'boiler_type', 'notes', 'is_active', 'prep_type', 'prep_style', 'archived', 'photo', 'tools', 'connected_device', 'built_in_grinder_id', 'catalog_id', 'hardness_dh'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': 'string'}, 'notes': {}, 'photo': {}, 'tools': {}, 'archived': {'type': 'integer'}, 'is_active': {'type': 'integer'}, 'prep_type': {}, 'catalog_id': {'type': 'string'}, 'prep_style': {}, 'boiler_type': {'type': 'string'}, 'hardness_dh': {}, 'control_type': {'type': 'string'}, 'connected_device': {}, 'basket_size_grams': {'type': 'integer'}, 'built_in_grinder_id': {}}, 'additionalProperties': True}, 'active_program': {}, 'maintenance_summary': {'type': 'object', 'required': ['computed_at', 'catalog_version', 'most_urgent', 'due_count', 'overdue_count', 'soon_count', 'calibration_state'], 'properties': {'due_count': {'type': 'integer'}, 'soon_count': {'type': 'integer'}, 'computed_at': {'type': 'string'}, 'most_urgent': {'type': 'object', 'required': ['equipment_kind', 'equipment_id', 'equipment_name', 'task', 'label', 'class', 'state', 'ratio', 'basis', 'every', 'done', 'remaining', 'last_at', 'every_source', 'lower_bound', 'soon', 'soon_at', 'due_at', 'overdue_at', 'muted', 'muted_until'], 'properties': {'done': {'type': 'integer'}, 'soon': {'type': 'boolean'}, 'task': {'type': 'string'}, 'basis': {'type': 'string'}, 'class': {'type': 'string'}, 'every': {'type': 'integer'}, 'label': {'type': 'string'}, 'muted': {'type': 'boolean'}, 'ratio': {'type': 'number'}, 'state': {'type': 'string'}, 'due_at': {}, 'last_at': {}, 'soon_at': {}, 'remaining': {'type': 'integer'}, 'overdue_at': {}, 'lower_bound': {'type': 'boolean'}, 'muted_until': {}, 'equipment_id': {'type': 'integer'}, 'every_source': {'type': 'string'}, 'equipment_kind': {'type': 'string'}, 'equipment_name': {'type': 'string'}}, 'additionalProperties': True}, 'overdue_count': {'type': 'integer'}, 'catalog_version': {'type': 'string'}, 'calibration_state': {'type': 'string'}}, 'additionalProperties': True}, 'recent_recommendations': {'type': 'array', 'items': {'type': 'object', 'required': ['created_at', 'bean_id', 'grinder_id', 'machine_id', 'based_on_shot', 'lever', 'direction', 'rationale', 'confidence', 'cited_rules', 'kb_version'], 'properties': {'lever': {'type': 'string'}, 'bean_id': {'type': 'integer'}, 'direction': {'type': 'string'}, 'rationale': {'type': 'string'}, 'confidence': {'type': 'string'}, 'created_at': {'type': 'string'}, 'grinder_id': {'type': 'integer'}, 'kb_version': {'type': 'string'}, 'machine_id': {'type': 'integer'}, 'cited_rules': {'type': 'string'}, 'based_on_shot': {}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['kb_version'], 'properties': {'kb_version': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'guide_ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 50, 'description': "Optional — the guides to fetch. Omit for every guide the user's equipment can use"}}}

{'type': 'object', 'required': ['catalog_version', 'guides', 'missing'], 'properties': {'guides': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'task', 'kind', 'scope', 'brand', 'applies_to', 'title', 'basis', 'researched_at', 'sources', 'machine_alert', 'duration_minutes', 'supplies', 'tools', 'steps', 'warnings', 'gaps'], 'properties': {'id': {'type': 'string'}, 'gaps': {'type': 'array', 'items': {'type': 'string'}}, 'kind': {'type': 'string'}, 'task': {'type': 'string'}, 'basis': {'type': 'string'}, 'brand': {'type': 'string'}, 'scope': {'type': 'string'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'required': ['n', 'text', 'source'], 'properties': {'n': {'type': 'integer'}, 'text': {'type': 'string'}, 'when': {'type': 'string'}, 'source': {'type': 'string'}, 'optional': {'type': 'boolean'}}, 'additionalProperties': True}}, 'title': {'type': 'string'}, 'tools': {'type': 'array', 'items': {'type': 'string'}}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['ref', 'url', 'type', 'title'], 'properties': {'ref': {'type': 'string'}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': True}}, 'variant': {'type': 'string'}, 'supplies': {'type': 'array', 'items': {'type': 'object', 'required': ['item', 'spec', 'required'], 'properties': {'item': {'type': 'string'}, 'spec': {'type': 'string'}, 'source': {'type': 'string'}, 'required': {'type': 'boolean'}}, 'additionalProperties': True}}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'source'], 'properties': {'text': {'type': 'string'}, 'source': {'type': 'string'}}, 'additionalProperties': True}}, 'preferred': {'type': 'boolean'}, 'applies_to': {'type': 'array', 'items': {'type': 'string'}}, 'also_covers': {'type': 'array', 'items': {'type': 'string'}}, 'machine_alert': {'type': ['null', 'object'], 'required': [], 'properties': {'clears': {'type': ['string', 'null']}, 'counts': {'type': 'string'}, 'source': {'type': 'string'}, 'shown_as': {'type': 'string'}, 'indicator': {'type': 'string'}, 'threshold': {}, 'can_disable': {}, 'depends_on_setting': {}}, 'additionalProperties': True}, 'researched_at': {'type': 'string'}, 'duration_minutes': {'type': ['null', 'integer']}}, 'additionalProperties': True}}, 'missing': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'catalog_version': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['rule_id'], 'properties': {'rule_id': {'type': 'string', 'description': 'The ID of the rule to fetch, e.g. CAT.DARK'}}}

{'type': 'object', 'required': ['rule_id', 'text'], 'properties': {'text': {'type': 'string'}, 'rule_id': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['scope', 'id'], 'properties': {'id': {'type': 'integer', 'description': 'The entity ID'}, 'scope': {'enum': ['grinder', 'machine', 'bean'], 'type': 'string', 'description': 'The stats scope'}}}

{'type': 'object', 'required': ['brews'], 'properties': {'brews': {'type': 'integer'}, 'last_bean': {'type': 'string'}, 'last_used': {'type': 'string'}, 'grams_ground': {'type': 'integer'}, 'effective_age': {'type': 'integer'}, 'beans_consumed': {'type': 'integer'}, 'grams_consumed': {'type': 'integer'}, 'grams_remaining': {'type': 'integer'}, 'last_grind_setting': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['grinder_id', 'from_label', 'to_label'], 'properties': {'to_label': {'type': 'string'}, 'from_label': {'type': 'string'}, 'grinder_id': {'type': 'integer'}}}

{'type': 'object', 'required': ['direction', 'steps', 'step_unit', 'burr_gap_travel_microns', 'relative_coarseness_note'], 'properties': {'steps': {'type': 'integer'}, 'direction': {'type': 'string'}, 'step_unit': {'type': 'string'}, 'burr_gap_travel_microns': {'type': 'integer'}, 'relative_coarseness_note': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['changelog'], 'properties': {'changelog': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'status': {'enum': ['current', 'archived', 'all'], 'type': 'string', 'description': 'Filter by status: current, archived, or all. Defaults to current.'}}}

{'type': 'object', 'required': ['beans'], 'properties': {'beans': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'roaster', 'roast_level', 'archived', 'favourite', 'decaffeinated', 'process_type', 'dial_category', 'rest_window_days_min', 'rest_window_days_max', 'rating', 'aromatics', 'cupping_points', 'roasting_type', 'variety', 'origin', 'url', 'notes', 'arabica_pct', 'body', 'acidity', 'sweetness', 'roast_date', 'buy_date', 'opened_date', 'best_by_date', 'bag_weight_g', 'weight_adjustment_g', 'cost', 'currency', 'state', 'finished', 'frozen_at', 'unfrozen_at', 'frozen_storage', 'frozen_note', 'storage', 'ean', 'qr_code', 'bag_notes', 'effective_age_days', 'age_verdict', 'grams_remaining', 'days_since_opened', 'days_off_roast', 'frozen_days_excluded', 'current_bag_id', 'bags', 'origins'], 'properties': {'id': {'type': 'integer'}, 'ean': {}, 'url': {}, 'bags': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'bean_id', 'roast_date', 'buy_date', 'opened_date', 'best_by_date', 'bag_weight_g', 'weight_adjustment_g', 'cost', 'currency', 'state', 'finished', 'frozen_at', 'unfrozen_at', 'frozen_storage', 'frozen_note', 'storage', 'ean', 'qr_code', 'bag_notes', 'archived', 'effective_age_days', 'age_verdict', 'grams_remaining', 'days_since_opened', 'days_off_roast', 'frozen_days_excluded'], 'properties': {'id': {'type': 'integer'}, 'ean': {}, 'cost': {'type': ['null', 'integer']}, 'state': {'type': 'string'}, 'bean_id': {'type': 'integer'}, 'qr_code': {}, 'storage': {}, 'archived': {'type': 'integer'}, 'buy_date': {}, 'currency': {'type': ['null', 'string']}, 'finished': {'type': 'integer'}, 'bag_notes': {'type': ['null', 'string']}, 'frozen_at': {}, 'roast_date': {'type': 'string'}, 'age_verdict': {'type': 'string'}, 'frozen_note': {}, 'opened_date': {}, 'unfrozen_at': {}, 'bag_weight_g': {'type': ['integer', 'null']}, 'best_by_date': {}, 'days_off_roast': {'type': 'integer'}, 'frozen_storage': {}, 'grams_remaining': {'type': ['integer', 'null']}, 'shots_remaining': {'type': 'integer'}, 'days_since_opened': {}, 'effective_age_days': {'type': 'integer'}, 'weight_adjustment_g': {'type': 'integer'}, 'frozen_days_excluded': {'type': 'integer'}, 'shots_remaining_basis': {'type': 'string'}, 'shots_remaining_dose_g': {'type': ['integer', 'number']}, 'shots_remaining_sample': {'type': ['integer', 'null']}}, 'additionalProperties': True}}, 'body': {}, 'cost': {}, 'name': {'type': 'string'}, 'notes': {'type': ['null', 'string']}, 'state': {'type': 'string'}, 'origin': {}, 'rating': {}, 'acidity': {}, 'origins': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'region', 'farm', 'farmer', 'variety', 'processing', 'elevation_m', 'elevation_max_m', 'harvest', 'percentage'], 'properties': {'farm': {}, 'farmer': {}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'harvest': {}, 'variety': {'type': 'string'}, 'percentage': {'type': 'integer'}, 'processing': {}, 'elevation_m': {}, 'elevation_max_m': {}}, 'additionalProperties': True}}, 'qr_code': {}, 'roaster': {'type': 'string'}, 'storage': {}, 'variety': {}, 'archived': {'type': 'integer'}, 'buy_date': {}, 'currency': {}, 'finished': {'type': 'integer'}, 'aromatics': {}, 'bag_notes': {'type': ['null', 'string']}, 'favourite': {'type': ['integer', 'null']}, 'frozen_at': {}, 'sweetness': {}, 'roast_date': {'type': 'string'}, 'age_verdict': {'type': 'string'}, 'arabica_pct': {}, 'frozen_note': {}, 'opened_date': {}, 'roast_level': {'type': 'string'}, 'unfrozen_at': {}, 'bag_weight_g': {'type': ['integer', 'null']}, 'best_by_date': {}, 'process_type': {'type': 'string'}, 'decaffeinated': {'type': ['integer', 'null']}, 'dial_category': {'type': 'string'}, 'roasting_type': {}, 'cupping_points': {}, 'current_bag_id': {'type': ['integer', 'null']}, 'days_off_roast': {'type': 'integer'}, 'frozen_storage': {}, 'grams_remaining': {'type': ['integer', 'null']}, 'shots_remaining': {'type': 'integer'}, 'days_since_opened': {}, 'effective_age_days': {'type': 'integer'}, 'weight_adjustment_g': {'type': 'integer'}, 'frozen_days_excluded': {'type': 'integer'}, 'rest_window_days_max': {'type': ['integer', 'null']}, 'rest_window_days_min': {'type': ['integer', 'null']}, 'shots_remaining_basis': {'type': 'string'}, 'shots_remaining_dose_g': {'type': ['integer', 'number']}, 'shots_remaining_sample': {'type': ['integer', 'null']}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'status': {'enum': ['current', 'archived', 'all'], 'type': 'string', 'description': 'Filter by status: current, archived, or all. Defaults to current.'}, 'maintenance': {'enum': ['compact', 'full'], 'type': 'string', 'description': "How much of each row's maintenance block to include. compact (default): every task with its class, due state, schedule and guide. full: also the maker's own words — quote, source, alternates, the interval as written."}}}

{'type': 'object', 'required': ['grinders'], 'properties': {'grinders': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'motor_type', 'burr_type', 'setting_scheme', 'direction_convention', 'nominal_step', 'components_spec', 'min_value', 'max_value', 'microns_per_step', 'notes', 'archived', 'catalog_id', 'setting_label', 'setting_components', 'position_value', 'source', 'verified_at', 'built_in_machine_id', 'maintenance'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': 'string'}, 'notes': {'type': ['null', 'string']}, 'source': {'type': ['null', 'string']}, 'archived': {'type': 'integer'}, 'burr_type': {'type': 'string'}, 'max_value': {'type': ['null', 'integer']}, 'min_value': {'type': ['null', 'integer']}, 'catalog_id': {'type': ['null', 'string']}, 'motor_type': {'type': 'string'}, 'maintenance': {'type': 'object', 'required': ['tasks', 'due', 'calibration', 'sensitivity', 'entries', 'entries_total', 'catalog_version', 'computed_at', 'catalog', 'hardness'], 'properties': {'due': {'type': 'object', 'required': ['burr_clean'], 'properties': {'burr_clean': {'type': 'object', 'required': ['state', 'ratio', 'basis', 'every', 'done', 'remaining', 'lower_bound', 'soon', 'soon_at', 'due_at', 'overdue_at', 'last_at', 'every_source', 'muted', 'muted_until'], 'properties': {'done': {'type': ['null', 'integer']}, 'soon': {'type': 'boolean'}, 'basis': {'type': ['null', 'string']}, 'every': {'type': ['null', 'integer']}, 'muted': {'type': 'boolean'}, 'ratio': {'type': ['integer', 'number']}, 'state': {'type': 'string'}, 'due_at': {'type': ['null', 'string']}, 'last_at': {'type': ['null', 'string']}, 'soon_at': {'type': ['null', 'string']}, 'remaining': {'type': ['null', 'integer']}, 'overdue_at': {'type': ['null', 'string']}, 'lower_bound': {'type': 'boolean'}, 'muted_until': {}, 'every_source': {'type': ['null', 'string']}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'tasks': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'kind', 'label', 'sub', 'disturbs_zero', 'every', 'why', 'disturbs_note', 'offset_unit', 'offset_integral', 'scheduled', 'opened_by', 'details_version', 'details_fields', 'class', 'status', 'trigger', 'every_source', 'disturbs_prompt', 'guide', 'schedule'], 'properties': {'sub': {'type': 'string'}, 'why': {'type': 'string'}, 'kind': {'type': 'string'}, 'class': {'type': 'string'}, 'every': {'type': ['null', 'object'], 'required': [], 'properties': {'days': {'type': 'integer'}, 'grams': {'type': 'integer'}, 'shots': {'type': 'integer'}}, 'additionalProperties': True}, 'guide': {'type': ['object', 'null'], 'required': [], 'properties': {'id': {'type': 'string'}, 'basis': {'type': 'string'}, 'scope': {'type': 'string'}, 'steps': {'type': 'integer'}, 'title': {'type': 'string'}, 'market': {}, 'variant': {'type': 'string'}, 'warnings': {'type': 'integer'}, 'also_covers': {}, 'duration_note': {}, 'machine_alert': {}, 'duration_minutes': {}}, 'additionalProperties': True}, 'label': {'type': 'string'}, 'value': {'type': 'string'}, 'status': {'type': ['string', 'null']}, 'trigger': {'type': ['string', 'null']}, 'schedule': {'type': ['null', 'object'], 'required': [], 'properties': {'every': {}, 'enabled': {'type': 'boolean'}, 'muted_until': {}}, 'additionalProperties': True}, 'opened_by': {'type': ['null', 'string']}, 'scheduled': {'type': 'boolean'}, 'offset_unit': {'type': 'string'}, 'every_source': {'type': ['null', 'object'], 'required': [], 'properties': {'days': {'type': 'string'}, 'grams': {'type': 'string'}, 'shots': {'type': 'string'}}, 'additionalProperties': True}, 'disturbs_note': {'type': 'string'}, 'disturbs_zero': {'type': 'boolean'}, 'details_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'type', 'label', 'hint', 'required'], 'properties': {'key': {'type': 'string'}, 'hint': {'type': 'string'}, 'type': {'type': 'string'}, 'label': {'type': 'string'}, 'required': {'type': 'boolean'}}, 'additionalProperties': True}}, 'details_version': {'type': 'integer'}, 'disturbs_prompt': {'type': ['null', 'string']}, 'offset_integral': {'type': 'boolean'}}, 'additionalProperties': True}}, 'catalog': {'type': 'object', 'required': ['id', 'brand', 'model', 'via', 'match', 'declined'], 'properties': {'id': {'type': ['string', 'null']}, 'via': {'type': ['string', 'null']}, 'brand': {'type': ['string', 'null']}, 'match': {'type': ['null', 'object'], 'required': [], 'properties': {'by': {'type': 'string'}, 'id': {'type': 'string'}, 'brand': {'type': 'string'}, 'model': {'type': 'string'}}, 'additionalProperties': True}, 'model': {'type': ['string', 'null']}, 'declined': {'type': 'boolean'}}, 'additionalProperties': True}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'equipment_kind', 'equipment_id', 'task', 'performed_at', 'disturbs_zero', 'note', 'offset_value', 'offset_source', 'offset_at', 'evidence', 'details', 'details_version', 'created_at', 'guide_id', 'details_known', 'task_label'], 'properties': {'id': {'type': 'integer'}, 'note': {'type': ['string', 'null']}, 'task': {'type': 'string'}, 'details': {'type': ['object', 'null'], 'required': [], 'properties': {'to': {'type': 'object', 'required': ['setting_scheme', 'nominal_step', 'components_spec'], 'properties': {'nominal_step': {'type': ['number', 'integer']}, 'setting_scheme': {'type': 'string'}, 'components_spec': {'type': ['null', 'string']}}, 'additionalProperties': True}, 'from': {'type': 'object', 'required': ['setting_scheme', 'nominal_step', 'components_spec'], 'properties': {'nominal_step': {'type': ['number', 'integer']}, 'setting_scheme': {'type': 'string'}, 'components_spec': {'type': ['null', 'string']}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'evidence': {'type': ['null', 'string']}, 'guide_id': {}, 'offset_at': {'type': ['null', 'string']}, 'created_at': {'type': 'string'}, 'task_label': {'type': 'string'}, 'equipment_id': {'type': 'integer'}, 'offset_value': {'type': ['null', 'integer']}, 'performed_at': {'type': 'string'}, 'details_known': {'type': 'boolean'}, 'disturbs_zero': {'type': 'integer'}, 'offset_source': {'type': ['null', 'string']}, 'equipment_kind': {'type': 'string'}, 'details_version': {'type': 'integer'}}, 'additionalProperties': True}}, 'hardness': {}, 'calibration': {'type': 'object', 'required': ['stale_recipe_count', 'untranslatable_recipe_count', 'reference_recipe_id', 'state', 'epoch_id', 'epoch_task', 'disturbs_note', 'epoch_at', 'offset_value', 'offset_unit', 'offset_source', 'offset_at', 'evidence'], 'properties': {'state': {'type': 'string'}, 'epoch_at': {'type': ['null', 'string']}, 'epoch_id': {'type': ['null', 'integer']}, 'evidence': {'type': ['null', 'string']}, 'offset_at': {'type': ['null', 'string']}, 'epoch_task': {'type': ['null', 'string']}, 'offset_unit': {'type': 'string'}, 'offset_value': {'type': ['null', 'integer']}, 'disturbs_note': {'type': ['null', 'string']}, 'offset_source': {'type': ['null', 'string']}, 'stale_recipe_count': {'type': 'integer'}, 'reference_recipe_id': {'type': ['null', 'integer']}, 'untranslatable_recipe_count': {'type': 'integer'}}, 'additionalProperties': True}, 'computed_at': {'type': 'string'}, 'sensitivity': {}, 'entries_total': {'type': 'integer'}, 'catalog_version': {'type': 'string'}}, 'additionalProperties': True}, 'verified_at': {'type': ['null', 'string']}, 'nominal_step': {'type': ['integer', 'number']}, 'setting_label': {'type': ['null', 'string']}, 'position_value': {'type': ['null', 'integer']}, 'setting_scheme': {'type': 'string'}, 'components_spec': {'type': ['null', 'string']}, 'microns_per_step': {'type': ['null', 'integer']}, 'setting_components': {'type': ['null', 'string']}, 'built_in_machine_id': {'type': ['integer', 'null']}, 'direction_convention': {'type': 'string'}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'status': {'enum': ['current', 'archived', 'all'], 'type': 'string', 'description': 'Filter by status: current, archived, or all. Defaults to current.'}, 'maintenance': {'enum': ['compact', 'full'], 'type': 'string', 'description': "How much of each row's maintenance block to include. compact (default): every task with its class, due state, schedule and guide. full: also the maker's own words — quote, source, alternates, the interval as written."}}}

{'type': 'object', 'required': ['machines'], 'properties': {'machines': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'control_type', 'basket_size_grams', 'boiler_type', 'notes', 'prep_type', 'prep_style', 'archived', 'built_in_grinder_id', 'catalog_id', 'hardness_dh', 'tools_list', 'programs', 'maintenance'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': 'string'}, 'notes': {'type': ['string', 'null']}, 'archived': {'type': 'integer'}, 'programs': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'program_number', 'program_type', 'target_volume_g', 'target_time_s', 'volume_source', 'description', 'is_active'], 'properties': {'id': {'type': 'integer'}, 'is_active': {'type': 'integer'}, 'description': {'type': ['string', 'null']}, 'program_type': {'type': 'string'}, 'target_time_s': {}, 'volume_source': {'type': 'string'}, 'program_number': {'type': 'integer'}, 'target_volume_g': {'type': 'integer'}}, 'additionalProperties': True}}, 'prep_type': {'type': ['string', 'null']}, 'catalog_id': {'type': ['null', 'string']}, 'prep_style': {'type': ['string', 'null']}, 'tools_list': {'type': 'array', 'items': {'type': 'string'}}, 'boiler_type': {'type': ['null', 'string']}, 'hardness_dh': {'type': ['null', 'number']}, 'maintenance': {'type': 'object', 'required': ['tasks', 'due', 'calibration', 'sensitivity', 'entries', 'entries_total', 'catalog_version', 'computed_at', 'catalog', 'hardness'], 'properties': {'due': {'type': ['null', 'object'], 'required': [], 'properties': {}, 'additionalProperties': {'type': 'object', 'required': ['state', 'ratio', 'basis', 'every', 'done', 'remaining', 'lower_bound', 'soon', 'soon_at', 'due_at', 'overdue_at', 'last_at', 'every_source', 'muted', 'muted_until'], 'properties': {'done': {'type': ['null', 'integer']}, 'soon': {'type': 'boolean'}, 'basis': {'type': ['null', 'string']}, 'every': {'type': ['null', 'integer']}, 'muted': {'type': 'boolean'}, 'ratio': {'type': ['integer', 'number']}, 'state': {'type': 'string'}, 'due_at': {'type': ['null', 'string']}, 'last_at': {'type': ['null', 'string']}, 'soon_at': {'type': ['null', 'string']}, 'remaining': {'type': ['null', 'integer']}, 'overdue_at': {'type': ['null', 'string']}, 'lower_bound': {'type': 'boolean'}, 'muted_until': {'type': ['null', 'string']}, 'every_source': {'type': ['null', 'string']}}, 'additionalProperties': True}}, 'tasks': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'kind', 'label', 'sub', 'disturbs_zero', 'every', 'why', 'disturbs_note', 'offset_unit', 'offset_integral', 'scheduled', 'opened_by', 'details_version', 'details_fields', 'class', 'status', 'trigger', 'every_source', 'disturbs_prompt', 'guide', 'schedule'], 'properties': {'sub': {'type': 'string'}, 'why': {'type': 'string'}, 'kind': {'type': 'string'}, 'class': {'type': 'string'}, 'every': {'type': ['null', 'object'], 'required': [], 'properties': {'days': {'type': 'integer'}, 'shots': {'type': 'integer'}, 'litres': {'type': ['integer', 'number']}}, 'additionalProperties': True}, 'guide': {'type': ['null', 'object'], 'required': [], 'properties': {'id': {'type': 'string'}, 'basis': {'type': 'string'}, 'scope': {'type': 'string'}, 'steps': {'type': 'integer'}, 'title': {'type': 'string'}, 'market': {}, 'variant': {}, 'warnings': {'type': 'integer'}, 'also_covers': {}, 'duration_note': {}, 'machine_alert': {'type': ['object', 'null'], 'required': [], 'properties': {'clears': {'type': ['null', 'string']}, 'counts': {'type': 'string'}, 'source': {'type': 'string'}, 'shown_as': {'type': 'string'}, 'indicator': {'type': 'string'}, 'threshold': {}, 'can_disable': {}, 'depends_on_setting': {}}, 'additionalProperties': True}, 'duration_minutes': {'type': ['integer', 'null']}}, 'additionalProperties': True}, 'label': {'type': 'string'}, 'value': {'type': 'string'}, 'status': {'type': ['null', 'string']}, 'trigger': {'type': ['null', 'string']}, 'schedule': {'type': ['null', 'object'], 'required': [], 'properties': {'every': {'type': 'object', 'required': ['days', 'litres'], 'properties': {'days': {'type': 'integer'}, 'litres': {'type': 'number'}}, 'additionalProperties': True}, 'enabled': {'type': 'boolean'}, 'muted_until': {'type': 'string'}}, 'additionalProperties': True}, 'opened_by': {}, 'scheduled': {'type': 'boolean'}, 'offset_unit': {'type': 'string'}, 'every_source': {'type': ['null', 'object'], 'required': [], 'properties': {'days': {'type': 'string'}, 'shots': {'type': 'string'}, 'litres': {'type': 'string'}}, 'additionalProperties': True}, 'disturbs_note': {'type': 'string'}, 'disturbs_zero': {'type': 'boolean'}, 'details_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'type', 'label', 'hint', 'required'], 'properties': {'key': {'type': 'string'}, 'hint': {'type': ['string', 'null']}, 'type': {'type': 'string'}, 'label': {'type': 'string'}, 'source': {'type': 'string'}, 'options': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'label'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': True}}, 'required': {'type': 'boolean'}}, 'additionalProperties': True}}, 'details_version': {'type': 'integer'}, 'disturbs_prompt': {}, 'offset_integral': {'type': 'boolean'}}, 'additionalProperties': True}}, 'catalog': {'type': 'object', 'required': ['id', 'brand', 'model', 'via', 'match', 'declined'], 'properties': {'id': {'type': ['null', 'string']}, 'via': {}, 'brand': {'type': ['null', 'string']}, 'match': {}, 'model': {'type': ['null', 'string']}, 'declined': {'type': 'boolean'}}, 'additionalProperties': True}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'equipment_kind', 'equipment_id', 'task', 'performed_at', 'disturbs_zero', 'note', 'offset_value', 'offset_source', 'offset_at', 'evidence', 'details', 'details_version', 'created_at', 'guide_id', 'details_known', 'task_label'], 'properties': {'id': {'type': 'integer'}, 'note': {}, 'task': {'type': 'string'}, 'details': {'type': 'object', 'required': [], 'properties': {'label': {'type': 'string'}, 'product': {'type': 'string'}, 'filter_id': {'type': 'string'}}, 'additionalProperties': True}, 'evidence': {}, 'guide_id': {'type': ['null', 'string']}, 'offset_at': {}, 'created_at': {'type': 'string'}, 'task_label': {'type': 'string'}, 'equipment_id': {'type': 'integer'}, 'offset_value': {}, 'performed_at': {'type': 'string'}, 'details_known': {'type': 'boolean'}, 'disturbs_zero': {'type': 'integer'}, 'offset_source': {}, 'equipment_kind': {'type': 'string'}, 'details_version': {'type': 'integer'}}, 'additionalProperties': True}}, 'hardness': {'type': 'object', 'required': ['dh', 'dkh', 'source', 'dkh_source'], 'properties': {'dh': {'type': ['null', 'number']}, 'dkh': {'type': ['null', 'number']}, 'source': {'type': ['null', 'string']}, 'dkh_source': {'type': ['null', 'string']}}, 'additionalProperties': True}, 'calibration': {'type': 'object', 'required': ['stale_recipe_count', 'untranslatable_recipe_count', 'reference_recipe_id', 'state', 'epoch_id', 'epoch_task', 'disturbs_note', 'epoch_at', 'offset_value', 'offset_unit', 'offset_source', 'offset_at', 'evidence'], 'properties': {'state': {'type': 'string'}, 'epoch_at': {}, 'epoch_id': {}, 'evidence': {}, 'offset_at': {}, 'epoch_task': {}, 'offset_unit': {}, 'offset_value': {}, 'disturbs_note': {}, 'offset_source': {}, 'stale_recipe_count': {'type': 'integer'}, 'reference_recipe_id': {}, 'untranslatable_recipe_count': {'type': 'integer'}}, 'additionalProperties': True}, 'computed_at': {'type': 'string'}, 'sensitivity': {}, 'entries_total': {'type': 'integer'}, 'catalog_version': {'type': 'string'}}, 'additionalProperties': True}, 'control_type': {'type': 'string'}, 'basket_size_grams': {'type': ['null', 'integer']}, 'built_in_grinder_id': {'type': ['null', 'integer']}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'status': {'enum': ['due', 'all'], 'type': 'string', 'description': 'due (default): due or overdue, and not muted. all: every scheduled task, muted ones last'}}}

{'type': 'object', 'required': ['catalog_version', 'computed_at', 'items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['equipment_kind', 'equipment_id', 'equipment_name', 'task', 'label', 'class', 'state', 'ratio', 'basis', 'every', 'done', 'remaining', 'last_at', 'every_source', 'lower_bound', 'soon', 'soon_at', 'due_at', 'overdue_at', 'muted', 'muted_until'], 'properties': {'done': {'type': ['integer', 'null']}, 'soon': {'type': 'boolean'}, 'task': {'type': 'string'}, 'basis': {'type': ['string', 'null']}, 'class': {'type': 'string'}, 'every': {'type': ['integer', 'null']}, 'label': {'type': 'string'}, 'muted': {'type': 'boolean'}, 'ratio': {'type': ['number', 'integer']}, 'state': {'type': 'string'}, 'due_at': {'type': ['null', 'string']}, 'last_at': {'type': ['null', 'string']}, 'soon_at': {'type': ['null', 'string']}, 'remaining': {'type': ['integer', 'null']}, 'overdue_at': {'type': ['null', 'string']}, 'lower_bound': {'type': 'boolean'}, 'muted_until': {'type': ['null', 'string']}, 'equipment_id': {'type': 'integer'}, 'every_source': {'type': ['string', 'null']}, 'equipment_kind': {'type': 'string'}, 'equipment_name': {'type': 'string'}}, 'additionalProperties': True}}, 'computed_at': {'type': 'string'}, 'catalog_version': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'status': {'enum': ['current', 'archived', 'all'], 'type': 'string', 'description': 'Filter by status: current, archived, or all. Defaults to current.'}, 'bean_id': {'type': 'integer'}, 'grinder_id': {'type': 'integer'}, 'machine_id': {'type': 'integer'}}}

{'type': 'object', 'required': ['recipes'], 'properties': {'recipes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'bean_id', 'grinder_id', 'machine_id', 'program_id', 'status', 'grind_label', 'grind_position_value', 'dose_g', 'target_yield_g', 'target_time_s', 'finish_action', 'drink_intent', 'profile', 'locked_at', 'bean_name', 'roaster_name', 'grinder_name', 'machine_name', 'grind_reading'], 'properties': {'id': {'type': 'integer'}, 'dose_g': {'type': ['integer', 'number']}, 'status': {'type': 'string'}, 'bean_id': {'type': 'integer'}, 'profile': {'type': 'string'}, 'bean_name': {'type': 'string'}, 'locked_at': {'type': 'string'}, 'grinder_id': {'type': 'integer'}, 'machine_id': {'type': 'integer'}, 'program_id': {'type': ['null', 'integer']}, 'grind_label': {'type': 'string'}, 'drink_intent': {'type': 'string'}, 'grinder_name': {'type': 'string'}, 'machine_name': {'type': 'string'}, 'roaster_name': {'type': 'string'}, 'finish_action': {'type': 'string'}, 'grind_reading': {'type': ['null', 'object'], 'required': [], 'properties': {'label': {}, 'unmeasured': {'type': 'integer'}, 'epoch_tasks': {'type': 'array', 'items': {'type': 'string'}}, 'epochs_since': {'type': 'integer'}, 'offset_clicks': {}, 'untranslatable': {'type': 'boolean'}, 'offset_direction': {}}, 'additionalProperties': True}, 'target_time_s': {'type': 'integer'}, 'target_yield_g': {'type': ['integer', 'number']}, 'grind_position_value': {'type': 'integer'}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'status': {'enum': ['current', 'archived', 'all'], 'type': 'string', 'description': 'Filter by status: current (unarchived), archived, or all. Defaults to current.'}}}

{'type': 'object', 'required': ['scales'], 'properties': {'scales': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'scale_type', 'resolution_g', 'resolution_banded', 'capacity_g', 'width_mm', 'depth_mm', 'height_mm', 'water_resistance', 'connectivity', 'flow_rate_display', 'auto_tare', 'auto_timer', 'power', 'notes', 'archived'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': 'string'}, 'notes': {}, 'power': {}, 'archived': {'type': 'integer'}, 'depth_mm': {}, 'width_mm': {}, 'auto_tare': {}, 'height_mm': {}, 'auto_timer': {}, 'capacity_g': {}, 'scale_type': {'type': 'string'}, 'connectivity': {}, 'resolution_g': {'type': 'number'}, 'water_resistance': {}, 'flow_rate_display': {}, 'resolution_banded': {'type': 'integer'}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 500, 'minimum': 1, 'description': 'Number of records to return (1-500)'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Offset for pagination'}, 'filters': {'type': 'object', 'properties': {'best': {'enum': [0, 1], 'type': 'integer', 'description': 'Filter by best brew status'}, 'bag_id': {'type': 'integer', 'description': 'Filter by bag number (one purchase of a coffee)'}, 'bean_id': {'type': 'integer', 'description': 'Filter by coffee bean ID'}, 'date_to': {'type': 'string', 'description': 'Filter shots pulled on or before YYYY-MM-DD'}, 'date_from': {'type': 'string', 'description': 'Filter shots pulled on or after YYYY-MM-DD'}, 'favourite': {'enum': [0, 1], 'type': 'integer', 'description': 'Filter by favourite status'}, 'grinder_id': {'type': 'integer', 'description': 'Filter by grinder ID'}, 'machine_id': {'type': 'integer', 'description': 'Filter by machine ID'}, 'taste_pending': {'enum': [0, 1], 'type': 'integer', 'description': '1 = shots logged without sensory tags, a rating, or the tasted flip (tasting still owed); 0 = tasted shots'}}}}}

{'type': 'object', 'required': ['shots', 'total'], 'properties': {'shots': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'pulled_at', 'bean_id', 'grinder_id', 'machine_id', 'program_id', 'grind_label', 'grind_components', 'grind_position_value', 'dose_g', 'yield_g', 'time_s', 'flow_rate_gps', 'finish_action', 'drink_intent', 'flavor_notes', 'sensory_tags', 'observations', 'temp_taste', 'rating', 'verdict', 'data_confidence', 'temperature_c', 'bloom_time_s', 'first_drip_time_s', 'beverage_g', 'tds', 'ey_pct', 'water_id', 'vessel_name', 'vessel_weight_g', 'favourite', 'best_brew', 'tasted', 'bag_id', 'bean_name', 'taste_pending'], 'properties': {'id': {'type': 'integer'}, 'tds': {}, 'bag_id': {'type': 'integer'}, 'dose_g': {'type': 'integer'}, 'ey_pct': {}, 'rating': {}, 'tasted': {'type': 'integer'}, 'time_s': {'type': 'integer'}, 'bean_id': {'type': 'integer'}, 'verdict': {}, 'yield_g': {'type': 'integer'}, 'water_id': {}, 'bean_name': {'type': 'string'}, 'best_brew': {'type': 'integer'}, 'favourite': {'type': 'integer'}, 'pulled_at': {'type': 'string'}, 'beverage_g': {}, 'grinder_id': {'type': 'integer'}, 'machine_id': {'type': 'integer'}, 'program_id': {}, 'temp_taste': {'type': 'string'}, 'grind_label': {'type': 'string'}, 'vessel_name': {}, 'bloom_time_s': {}, 'drink_intent': {'type': 'string'}, 'flavor_notes': {'type': ['string', 'null']}, 'observations': {'type': 'string'}, 'sensory_tags': {'type': 'string'}, 'finish_action': {'type': 'string'}, 'flow_rate_gps': {'type': 'number'}, 'taste_pending': {'type': 'integer'}, 'temperature_c': {}, 'data_confidence': {'type': 'string'}, 'vessel_weight_g': {}, 'grind_components': {'type': 'string'}, 'first_drip_time_s': {}, 'grind_position_value': {'type': 'integer'}}, 'additionalProperties': True}}, 'total': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'status': {'enum': ['current', 'archived', 'all'], 'type': 'string', 'description': 'Filter by status: current (unarchived), archived, or all. Defaults to current.'}}}

{'type': 'object', 'required': ['waters'], 'properties': {'waters': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'type', 'tds', 'gh', 'kh', 'sodium', 'calcium', 'magnesium', 'notes', 'archived'], 'properties': {'gh': {'type': 'integer'}, 'id': {'type': 'integer'}, 'kh': {'type': 'integer'}, 'tds': {}, 'name': {'type': 'string'}, 'type': {}, 'notes': {}, 'sodium': {}, 'calcium': {}, 'archived': {'type': 'integer'}, 'magnesium': {}}, 'additionalProperties': True}}}, 'additionalProperties': True}

{'type': 'object', 'required': ['from_shot_id', 'drink_intent'], 'properties': {'drink_intent': {'enum': ['straight', 'milk'], 'type': 'string'}, 'from_shot_id': {'type': 'integer'}}}

{'type': 'object', 'required': ['status', 'recipe_id', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'recipe_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['equipment_kind', 'equipment_id', 'task'], 'properties': {'note': {'type': 'string', 'description': 'Optional — what you did, and anything that surprised you'}, 'task': {'enum': ['burr_clean', 'backflush_water', 'backflush_detergent', 'descale', 'group_gasket_replace', 'shower_screen_clean', 'shower_screen_replace', 'group_head_wipe', 'basket_portafilter_soak', 'steam_wand_purge', 'steam_wand_soak', 'drip_tray_clean', 'water_tank_clean', 'water_filter_replace', 'boiler_water_change', 'lever_piston_seal_replace', 'lever_lubricate', 'milk_system_clean', 'professional_service', 'builtin_grinder_burr_clean', 'builtin_grinder_burr_replace', 'grinder_quick_clean', 'grinder_cleaning_tablets', 'burr_replace', 'hopper_clean', 'grounds_cup_clean', 'bearing_lubricate', 'gasket_seal_replace', 'idle_rinse', 'water_wash', 'dishwasher', 'filter_prime', 'softener_regenerate', 'other'], 'type': 'string', 'description': 'Which maintenance job was performed'}, 'details': {'type': 'object', 'description': 'Fields specific to this task. Which ones a task takes is published as details_fields on each task; a burr clean takes none', 'additionalProperties': True}, 'evidence': {'type': 'string', 'description': 'One line recording what the measurement rested on, e.g. "Counted 6 clicks coarser at reassembly."'}, 'guide_id': {'type': 'string', 'description': 'Optional — the id of the maintenance guide that was followed. Must be a guide for this task'}, 'equipment_id': {'type': 'integer', 'description': 'The ID of that piece of equipment'}, 'offset_value': {'type': 'number', 'description': "The correction, if you measured it now: clicks to ADD to a pre-clean reading to get the same grind today, signed along the collar's own number direction. Omit it and the epoch stays unmeasured, which is a state the app shows rather than a zero it assumes"}, 'performed_at': {'type': 'string', 'description': 'When it was done (ISO 8601 or YYYY-MM-DD HH:MM:SS, UTC). Defaults to now; backdating is fine'}, 'disturbs_zero': {'enum': [0, 1], 'type': 'integer', 'description': "Whether this job disturbed the reference the stored numbers are read against — for a burr clean, whether the burrs actually came out. Defaults to the task's own answer; send 0 for a wipe-down that left the collar alone"}, 'offset_source': {'enum': ['pull', 'counted', 'typed'], 'type': 'string', 'description': 'How the offset was arrived at: pull (a reference shot), counted (clicks counted at reassembly), typed (asserted directly)'}, 'equipment_kind': {'enum': ['grinder', 'machine'], 'type': 'string', 'description': 'Which kind of equipment this job was done on'}}}

{'type': 'object', 'required': ['entry_id', 'entry', 'deduped', 'message'], 'properties': {'entry': {'type': 'object', 'required': ['id', 'equipment_kind', 'equipment_id', 'task', 'performed_at', 'disturbs_zero', 'note', 'offset_value', 'offset_source', 'offset_at', 'evidence', 'details', 'details_version', 'created_at', 'guide_id', 'details_known'], 'properties': {'id': {'type': 'integer'}, 'note': {'type': ['string', 'null']}, 'task': {'type': 'string'}, 'details': {'type': ['null', 'object'], 'required': [], 'properties': {'label': {'type': 'string'}, 'product': {'type': 'string'}, 'filter_id': {'type': 'string'}}, 'additionalProperties': True}, 'evidence': {'type': ['null', 'string']}, 'guide_id': {'type': ['null', 'string']}, 'offset_at': {'type': ['null', 'string']}, 'created_at': {'type': 'string'}, 'equipment_id': {'type': 'integer'}, 'offset_value': {'type': ['null', 'integer']}, 'performed_at': {'type': 'string'}, 'details_known': {'type': 'boolean'}, 'disturbs_zero': {'type': 'integer'}, 'offset_source': {'type': ['null', 'string']}, 'equipment_kind': {'type': 'string'}, 'details_version': {'type': 'integer'}}, 'additionalProperties': True}, 'deduped': {'type': 'boolean'}, 'message': {'type': 'string'}, 'entry_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['lever', 'direction', 'rationale', 'confidence'], 'properties': {'lever': {'enum': ['grind', 'yield', 'temp', 'program', 'prep', 'none'], 'type': 'string'}, 'direction': {'enum': ['finer', 'coarser', 'more', 'less', 'same'], 'type': 'string'}, 'rationale': {'type': 'string'}, 'confidence': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'cited_rules': {'type': 'array', 'items': {'type': 'string'}}, 'based_on_shot': {'type': 'integer'}}}

{'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['dose_g', 'yield_g', 'time_s', 'finish_action'], 'properties': {'tds': {'type': 'number', 'description': 'Total Dissolved Solids percentage (e.g. 9.1 or 1.35)'}, 'bag_id': {'type': ['integer', 'null'], 'description': "Which bag of the coffee the shot came from; defaults to its current (open) bag. Bag numbers are on list_beans' bags[]"}, 'dose_g': {'type': 'number'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'tasted': {'enum': [0, 1], 'type': 'integer', 'description': '1 = the shot was tasted at log time. The explicit way to record a CLEAN tasting: sensory tags all describe defects, so a good shot has none — without this flag (or a rating) it would be filed taste-pending. Tags or a rating also mark a shot as tasted; 0 (default) = taste later.'}, 'time_s': {'type': 'number'}, 'bean_id': {'type': ['integer', 'null'], 'description': 'Override: log against this bean instead of the active one (null = active)'}, 'verdict': {'type': 'string'}, 'yield_g': {'type': 'number'}, 'water_id': {'type': 'integer', 'description': 'Optional references to waters formulation'}, 'best_brew': {'enum': [0, 1], 'type': 'integer', 'description': '1 if marked as best brew, 0 otherwise'}, 'favourite': {'enum': [0, 1], 'type': 'integer', 'description': '1 if favourite, 0 otherwise'}, 'pulled_at': {'type': ['string', 'null'], 'description': 'When the shot was actually pulled (ISO 8601 or "YYYY-MM-DD HH:MM:SS"), for backdated entries. Defaults to now (null = now). When backdating, pass the returned shot_id to diagnose_shot explicitly — the default diagnosis target is the chronologically latest shot.'}, 'beverage_g': {'type': 'number', 'description': 'Yield mass excluding cup/vessel weight in grams'}, 'grinder_id': {'type': ['integer', 'null'], 'description': 'Override: grinder used, if not the active one (null = active)'}, 'machine_id': {'type': ['integer', 'null'], 'description': 'Override: machine used, if not the active one (null = active)'}, 'program_id': {'type': ['integer', 'null'], 'description': 'Override: machine program used, if not the active one (null = active)'}, 'temp_taste': {'enum': ['hot', 'warm', 'cold'], 'type': 'string'}, 'vessel_name': {'type': 'string', 'description': 'Cup/vessel name'}, 'bloom_time_s': {'type': 'number', 'description': 'Pre-wetting or bloom duration in seconds'}, 'drink_intent': {'enum': ['straight', 'milk'], 'type': 'string'}, 'flavor_notes': {'type': 'string', 'maxLength': 4096}, 'flow_profile': {'type': 'string', 'maxLength': 16384, 'description': 'Opaque flow profile data (JSON/TEXT)'}, 'method_tools': {'type': 'string', 'maxLength': 4096, 'description': 'JSON representation of method tools used (e.g., paper filters, screen)'}, 'observations': {'type': 'object', 'maxProperties': 64}, 'sensory_tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 64}, 'finish_action': {'enum': ['hard_stop', 'passive_drip'], 'type': 'string'}, 'temperature_c': {'type': 'number', 'description': 'Brew temperature in Celsius'}, 'data_confidence': {'enum': ['measured', 'recalled', 'estimated'], 'type': 'string', 'description': 'measured = weighed/timed live; recalled = from memory; estimated = a best guess (e.g. missed the timer — "~25s")'}, 'vessel_weight_g': {'type': 'number', 'description': 'Cup/vessel weight in grams'}, 'pressure_profile': {'type': 'string', 'maxLength': 16384, 'description': 'Pressure profile description or values'}, 'first_drip_time_s': {'type': 'number', 'description': 'Time to first drip in seconds'}}}

{'type': 'object', 'required': ['status', 'shot_id', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'shot_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['from_bean_id', 'into_bean_id'], 'properties': {'reason': {'type': 'string', 'description': "Optional note, recorded on the surviving coffee's notes with the merge"}, 'from_bean_id': {'type': 'integer', 'description': 'The duplicate: the coffee number that will be emptied and archived'}, 'into_bean_id': {'type': 'integer', 'description': 'The coffee number that keeps everything'}}}

{'type': 'object', 'required': ['status', 'into_bean_id', 'moved', 'replaced_recipes', 'active_followed', 'message'], 'properties': {'moved': {'type': 'object', 'required': ['bags', 'shots', 'recipes', 'recommendations'], 'properties': {'bags': {'type': 'integer'}, 'shots': {'type': 'integer'}, 'recipes': {'type': 'integer'}, 'recommendations': {'type': 'integer'}}, 'additionalProperties': True}, 'status': {'type': 'string'}, 'message': {'type': 'string'}, 'into_bean_id': {'type': 'integer'}, 'active_followed': {'type': 'boolean'}, 'replaced_recipes': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['bean_id', 'roast_date'], 'properties': {'ean': {'type': 'string'}, 'cost': {'type': 'number'}, 'state': {'enum': ['sealed', 'open', 'frozen', 'finished'], 'type': 'string', 'description': 'Defaults to sealed; the first log_shot against it opens it'}, 'bean_id': {'type': 'integer', 'description': "This account's own coffee number, from list_beans. Never guess one."}, 'qr_code': {'type': 'string'}, 'storage': {'type': 'string'}, 'buy_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'currency': {'type': 'string'}, 'bag_notes': {'type': 'string', 'maxLength': 4096, 'description': "Notes about THIS bag (a batch note, where it was bought). The coffee's own description lives on the coffee, in notes."}, 'roast_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'opened_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'bag_weight_g': {'type': 'number', 'description': 'Bag weight in grams'}, 'best_by_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}}}

{'type': 'object', 'required': ['status', 'bag_id', 'bean_id', 'message'], 'properties': {'bag_id': {'type': 'integer'}, 'status': {'type': 'string'}, 'bean_id': {'type': 'integer'}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['name', 'roast_date', 'roast_level', 'process_type'], 'properties': {'ean': {'type': 'string'}, 'url': {'type': 'string'}, 'body': {'type': 'string', 'description': 'Free text; roasters usually say low, medium or high'}, 'cost': {'type': 'number'}, 'name': {'type': 'string'}, 'notes': {'type': 'string', 'maxLength': 4096, 'description': "The coffee's own description — the roaster's tasting notes, the dialing approach that worked. Per bag notes go in bag_notes."}, 'state': {'enum': ['sealed', 'open', 'frozen', 'finished'], 'type': 'string'}, 'origin': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'acidity': {'type': 'string', 'description': 'Free text; roasters usually say low, medium or high'}, 'co2e_kg': {'type': 'number'}, 'origins': {'type': 'array', 'items': {'type': 'object', 'properties': {'farm': {'type': 'string'}, 'farmer': {'type': 'string'}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'harvest': {'type': 'string'}, 'variety': {'type': 'string'}, 'percentage': {'type': 'number'}, 'processing': {'type': 'string'}, 'elevation_m': {'type': 'number'}, 'elevation_max_m': {'type': 'number', 'description': 'Upper end of an elevation range, e.g. 1980 for "1800–1980 m"; elevation_m is the lower end'}}}, 'description': 'List of bean origin details'}, 'qr_code': {'type': 'string'}, 'roaster': {'type': 'string'}, 'storage': {'type': 'string'}, 'variety': {'type': 'string'}, 'archived': {'type': 'integer', 'description': '1 if archived, 0 otherwise'}, 'bean_mix': {'type': 'string', 'description': 'E.g. blend details'}, 'buy_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'currency': {'type': 'string'}, 'finished': {'type': 'integer', 'description': '1 if finished, 0 otherwise'}, 'aromatics': {'type': 'string', 'maxLength': 1024}, 'bag_notes': {'type': 'string', 'maxLength': 4096}, 'favourite': {'type': 'integer', 'description': '1 if favourite, 0 otherwise'}, 'frozen_at': {'type': 'string', 'description': 'Calendar day the bag went into the freezer, YYYY-MM-DD — a day, not a timestamp'}, 'sweetness': {'type': 'string', 'description': 'Free text; roasters usually say low, medium or high'}, 'roast_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'arabica_pct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Percent arabica, 100 for a pure arabica; the rest robusta'}, 'attachments': {'type': 'string', 'maxLength': 1024, 'description': 'JSON or comma-separated list of attachments'}, 'frozen_note': {'type': 'string'}, 'opened_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'roast_level': {'enum': ['ultra-light', 'light', 'medium', 'medium-dark', 'dark'], 'type': 'string'}, 'roast_range': {'type': 'string'}, 'unfrozen_at': {'type': 'string', 'description': 'Calendar day the bag came out, YYYY-MM-DD — a day, not a timestamp'}, 'bag_weight_g': {'type': 'number', 'description': 'Bag weight in grams'}, 'best_by_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'process_type': {'enum': ['washed', 'natural', 'honey', 'anaerobic', 'aerobic-extended', 'co-fermented', 'bioreactor', 'other'], 'type': 'string'}, 'roast_custom': {'type': 'string'}, 'decaffeinated': {'type': 'integer', 'description': '1 if decaf, 0 if regular'}, 'dial_category': {'enum': ['nordic-light', 'ultra-light', 'classic', 'processed', 'dark', 'aged'], 'type': 'string', 'description': 'Dialing behavior class: classic = medium/traditional espresso roasts (chocolate/nut, balanced); dark = genuinely dark/roasty; the light categories cover Nordic and ultra-light styles.'}, 'roasting_type': {'enum': ['filter', 'espresso', 'omni'], 'type': 'string'}, 'cupping_points': {'type': 'number'}, 'frozen_storage': {'type': 'string'}, 'rest_window_days_max': {'type': 'integer'}, 'rest_window_days_min': {'type': 'integer'}}}

{'type': 'object', 'required': ['status', 'bean_id', 'bag_id', 'active', 'message'], 'properties': {'active': {'type': 'boolean'}, 'bag_id': {'type': 'integer'}, 'status': {'type': 'string'}, 'bean_id': {'type': 'integer'}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['name', 'motor_type', 'burr_type', 'setting_scheme', 'direction_convention', 'nominal_step'], 'properties': {'name': {'type': 'string', 'description': 'The name/model of the grinder, e.g. Kinu M47'}, 'notes': {'type': 'string', 'description': 'Additional notes'}, 'photo': {'type': 'string', 'description': 'Photo path or URL'}, 'archived': {'type': 'integer', 'description': '1 if archived, 0 if active'}, 'burr_type': {'enum': ['conical', 'flat'], 'type': 'string'}, 'max_value': {'type': ['number', 'null'], 'description': 'Optional travel max bounds'}, 'min_value': {'type': ['number', 'null'], 'description': 'Optional travel min bounds'}, 'catalog_id': {'type': 'string', 'description': 'Optional — the maintenance catalog model this is (the `id` of a catalog row, e.g. rancilio-silvia), when it was registered from the catalog. Its maintenance then comes from that model\'s researched record. "none" says it is not in the catalog.'}, 'motor_type': {'enum': ['manual', 'electric'], 'type': 'string'}, 'nominal_step': {'type': 'number', 'description': 'Smallest adjustment increment (e.g. 1 click or 0.1collar units)'}, 'setting_scheme': {'enum': ['numeric_stepless', 'numeric_stepped', 'clicks_single', 'compound', 'named'], 'type': 'string', 'description': 'Collar mark style: single clicks or compound (rotation.number.clicks)'}, 'components_spec': {'type': 'string', 'maxLength': 4096, 'description': 'JSON mapping string representing compound adjustment math'}, 'microns_per_step': {'type': ['number', 'null'], 'description': 'Optional mechanical burr travel microns per nominal step'}, 'direction_convention': {'enum': ['lower_is_finer', 'higher_is_finer'], 'type': 'string'}}}

{'type': 'object', 'required': ['status', 'grinder_id', 'active', 'message'], 'properties': {'active': {'type': 'boolean'}, 'status': {'type': 'string'}, 'message': {'type': 'string'}, 'grinder_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['name', 'control_type'], 'properties': {'name': {'type': 'string', 'description': 'Machine name/model, e.g. Dedica EC685'}, 'notes': {'type': 'string'}, 'photo': {'type': 'string', 'description': 'Photo path or URL'}, 'tools': {'type': ['string', 'null'], 'description': 'JSON or comma-separated tools, e.g., paper filters, flow control, metal mesh'}, 'archived': {'type': 'integer', 'description': '1 if archived, 0 if active'}, 'prep_type': {'type': 'string', 'description': 'Preparation equipment type. One of: espresso_machine, lever_press, moka_pot, aeropress, french_press, v60_dripper, cold_brew. Lower snake_case.'}, 'catalog_id': {'type': 'string', 'description': 'Optional — the maintenance catalog model this is (the `id` of a catalog row, e.g. rancilio-silvia), when it was registered from the catalog. Its maintenance then comes from that model\'s researched record. "none" says it is not in the catalog.'}, 'prep_style': {'type': 'string', 'description': 'Preparation style. One of: espresso, filter, immersion, percolation. Only "espresso" is diagnosed by the dialing engine (G8) — anything else is recorded but never dialed, so do not guess this field.'}, 'boiler_type': {'type': 'string'}, 'hardness_dh': {'type': ['number', 'null'], 'description': "Optional — the TOTAL hardness (GH) of the water this machine runs on, in °dH (German degrees; ppm as CaCO3 ÷ 17.85), as a test strip reports it. Picks the band of a maker's hardness table for descaling and filter life"}, 'control_type': {'enum': ['volumetric', 'manual', 'lever'], 'type': 'string'}, 'connected_device': {'type': 'string', 'description': 'Metadata mapping to smart hardware APIs'}, 'basket_size_grams': {'type': 'number'}, 'built_in_grinder_id': {'type': 'integer', 'description': 'id of a grinder built into this machine (bean-to-cup / integrated grinder)'}}}

{'type': 'object', 'required': ['status', 'machine_id', 'active', 'message'], 'properties': {'active': {'type': 'boolean'}, 'status': {'type': 'string'}, 'message': {'type': 'string'}, 'machine_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['machine_id', 'program_number'], 'properties': {'machine_id': {'type': 'integer'}, 'description': {'type': ['string', 'null']}, 'program_type': {'enum': ['volumetric', 'timed'], 'type': 'string', 'description': 'Cutoff method: "volumetric" (weight) or "timed" (duration). Defaults to volumetric.'}, 'target_time_s': {'type': ['number', 'null'], 'description': 'Target shot duration cutoff in seconds (required for timed programs)'}, 'volume_source': {'enum': ['measured', 'recalled'], 'type': 'string', 'description': 'Confidence in the stored cutoff value, for either type'}, 'program_number': {'type': 'integer', 'description': 'Program number / button index (e.g. 1 or 2)'}, 'target_volume_g': {'type': ['number', 'null'], 'description': 'Target yield cutoff in grams (required for volumetric programs)'}}}

{'type': 'object', 'required': ['status', 'program_id', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'program_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['name', 'scale_type'], 'properties': {'name': {'type': 'string', 'description': 'Scale name/model, e.g. Acaia Lunar, Timemore Black Mirror Basic 2'}, 'notes': {'type': 'string', 'description': 'Additional notes'}, 'power': {'enum': ['usb_c', 'micro_usb', 'aa', 'aaa', 'mains'], 'type': 'string', 'description': 'How it is powered or recharged'}, 'depth_mm': {'type': ['number', 'null'], 'description': 'Platform depth in mm'}, 'width_mm': {'type': ['number', 'null'], 'description': 'Platform width in mm — measure your drip tray'}, 'auto_tare': {'type': ['integer', 'null'], 'description': '1 if it zeroes itself when a vessel is set down, 0 if not, null if unstated'}, 'height_mm': {'type': ['number', 'null'], 'description': 'Overall height in mm — the dimension that decides whether it fits under a group head'}, 'auto_timer': {'type': ['integer', 'null'], 'description': '1 if the timer starts on first flow, 0 if not, null if unstated'}, 'capacity_g': {'type': ['number', 'null'], 'description': 'Maximum weight in grams. The cup or portafilter counts against it'}, 'scale_type': {'enum': ['espresso', 'brew', 'dual', 'connected', 'dosing', 'training', 'bench'], 'type': 'string', 'description': 'What the scale is built for: espresso (drip-tray footprint), brew (pour-over platform), dual (both modes), connected (app/controller integration), dosing (gravimetric dispensing), training, bench (high capacity, coarse)'}, 'connectivity': {'enum': ['none', 'bluetooth', 'usb', 'bluetooth_usb'], 'type': 'string', 'description': 'How the scale talks to an app or a machine controller'}, 'resolution_g': {'type': ['number', 'null'], 'description': 'Finest published readability in grams. Leave null unless the maker states it'}, 'water_resistance': {'type': ['string', 'null'], 'description': 'IEC 60529 ingress code as published, e.g. IPX4, IPX6, IP67, or none'}, 'flow_rate_display': {'type': ['integer', 'null'], 'description': '1 if the scale shows live flow rate in g/s, 0 if it does not, null if the maker never said'}, 'resolution_banded': {'type': ['integer', 'null'], 'description': '1 when resolution_g only holds in the lowest weight band and coarsens with load — put the ladder in notes'}}}

{'type': 'object', 'required': ['status', 'scale_id', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'scale_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['name'], 'properties': {'gh': {'type': ['number', 'null'], 'description': 'General hardness (GH) in ppm'}, 'kh': {'type': ['number', 'null'], 'description': 'Karbonate hardness (KH) in ppm'}, 'tds': {'type': ['number', 'null'], 'description': 'TDS in ppm'}, 'name': {'type': 'string', 'description': 'Water formulation name, e.g. Lotus Light & Bright, Third Wave Water'}, 'type': {'type': 'string', 'description': 'Type, e.g., mineralized, tap, distilled, RO'}, 'notes': {'type': 'string', 'description': 'Additional notes'}, 'sodium': {'type': ['number', 'null'], 'description': 'Sodium concentration in ppm'}, 'calcium': {'type': ['number', 'null'], 'description': 'Calcium concentration in ppm'}, 'magnesium': {'type': ['number', 'null'], 'description': 'Magnesium concentration in ppm'}}}

{'type': 'object', 'required': ['status', 'water_id', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'water_id': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'bean_id': {'type': ['integer', 'null'], 'description': "This account's own bean number, as returned by list_beans. Never guess one; null = leave unchanged"}, 'grinder_id': {'type': ['integer', 'null'], 'description': "This account's own grinder number, as returned by list_grinders. Never guess one; null = leave unchanged"}, 'machine_id': {'type': ['integer', 'null'], 'description': "This account's own machine number, as returned by list_machines. Never guess one; null = leave unchanged"}, 'program_id': {'type': ['integer', 'null'], 'description': "A program number from the active machine's list. null = leave unchanged"}}}

{'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['kind', 'id', 'archived'], 'properties': {'id': {'type': 'integer', 'description': 'The ID of the equipment'}, 'kind': {'enum': ['grinder', 'machine', 'water', 'scale'], 'type': 'string', 'description': 'The kind of equipment to archive/restore'}, 'archived': {'enum': [0, 1], 'type': 'integer', 'description': '1 to archive, 0 to restore'}}}

{'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['grinder_id', 'setting_label', 'source'], 'properties': {'source': {'enum': ['measured', 'recalled', 'assumed'], 'type': 'string', 'description': 'Whether setting is verified ("measured") or guess ("recalled"/"assumed")'}, 'grinder_id': {'type': 'integer'}, 'setting_label': {'type': 'string', 'description': 'Verbatim display label, e.g. "1.1.2"'}}}

{'type': 'object', 'required': ['status', 'grinder_id', 'setting_label', 'position_value', 'source', 'message'], 'properties': {'source': {'type': 'string'}, 'status': {'type': 'string'}, 'message': {'type': 'string'}, 'grinder_id': {'type': 'integer'}, 'setting_label': {'type': 'string'}, 'position_value': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['entry_id'], 'properties': {'source': {'enum': ['pull', 'counted', 'typed'], 'type': 'string', 'description': 'How it was arrived at: pull, counted, or typed'}, 'entry_id': {'type': 'integer', 'description': 'The maintenance entry that opened the epoch, from list_grinders'}, 'evidence': {'type': 'string', 'description': 'One line recording what it rested on, e.g. "Reference pull 1.38 g/s against 1.74 g/s locked."'}, 'offset_value': {'type': 'number', 'description': 'Clicks to ADD to a pre-clean reading to get the same grind today, signed along the collar\'s own number direction. 0 records "unchanged"; omit to clear the measurement'}}}

{'type': 'object', 'required': ['entry', 'message'], 'properties': {'entry': {'type': 'object', 'required': ['id', 'equipment_kind', 'equipment_id', 'task', 'performed_at', 'disturbs_zero', 'note', 'offset_value', 'offset_source', 'offset_at', 'evidence', 'details', 'details_version', 'created_at', 'guide_id', 'details_known'], 'properties': {'id': {'type': 'integer'}, 'note': {'type': 'string'}, 'task': {'type': 'string'}, 'details': {'type': ['null', 'object'], 'required': [], 'properties': {'to': {'type': 'object', 'required': ['setting_scheme', 'nominal_step', 'components_spec'], 'properties': {'nominal_step': {'type': 'number'}, 'setting_scheme': {'type': 'string'}, 'components_spec': {}}, 'additionalProperties': True}, 'from': {'type': 'object', 'required': ['setting_scheme', 'nominal_step', 'components_spec'], 'properties': {'nominal_step': {'type': 'integer'}, 'setting_scheme': {'type': 'string'}, 'components_spec': {'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'evidence': {'type': ['string', 'null']}, 'guide_id': {}, 'offset_at': {'type': 'string'}, 'created_at': {'type': 'string'}, 'equipment_id': {'type': 'integer'}, 'offset_value': {'type': 'integer'}, 'performed_at': {'type': 'string'}, 'details_known': {'type': 'boolean'}, 'disturbs_zero': {'type': 'integer'}, 'offset_source': {'type': 'string'}, 'equipment_kind': {'type': 'string'}, 'details_version': {'type': 'integer'}}, 'additionalProperties': True}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['equipment_kind', 'equipment_id', 'task'], 'properties': {'task': {'enum': ['burr_clean', 'backflush_water', 'backflush_detergent', 'descale', 'group_gasket_replace', 'shower_screen_clean', 'shower_screen_replace', 'group_head_wipe', 'basket_portafilter_soak', 'steam_wand_purge', 'steam_wand_soak', 'drip_tray_clean', 'water_tank_clean', 'water_filter_replace', 'boiler_water_change', 'lever_piston_seal_replace', 'lever_lubricate', 'milk_system_clean', 'professional_service', 'builtin_grinder_burr_clean', 'builtin_grinder_burr_replace', 'grinder_quick_clean', 'grinder_cleaning_tablets', 'burr_replace', 'hopper_clean', 'grounds_cup_clean', 'bearing_lubricate', 'gasket_seal_replace', 'idle_rinse', 'water_wash', 'dishwasher', 'filter_prime', 'softener_regenerate', 'other'], 'type': 'string', 'description': "The task, as its value in that equipment's maintenance.tasks"}, 'fields': {'type': 'object', 'properties': {'every': {'type': ['object', 'null'], 'properties': {'days': {'type': ['number', 'null'], 'description': 'Whole days'}, 'grams': {'type': ['number', 'null'], 'description': 'Grams of coffee through a grinder'}, 'shots': {'type': ['number', 'null'], 'description': 'Whole shots'}, 'litres': {'type': ['number', 'null'], 'description': "Litres through a machine's group"}}, 'description': "The user's interval: whichever basis arrives first makes it due. A grinder counts days, shots and grams; a machine days, shots and litres. null returns to the maker's guidance"}, 'enabled': {'type': 'boolean', 'description': "false sets the user's interval aside (the maker's applies again) without forgetting it"}, 'muted_until': {'type': ['string', 'null'], 'description': 'Silence the reminder until this date or time (ISO 8601, UTC); null unmutes'}}}, 'changed_at': {'type': 'string', 'description': 'Optional — when the user made this change (ISO 8601, UTC). An app sending a queued edit passes it, so an older edit never overwrites a newer one; it is then answered with applied: false'}, 'equipment_id': {'type': 'integer', 'description': "This account's own grinder or machine number, from list_grinders or list_machines"}, 'equipment_kind': {'enum': ['grinder', 'machine'], 'type': 'string', 'description': 'Which kind of equipment the task is on'}}}

{'type': 'object', 'required': ['equipment_kind', 'equipment_id', 'task', 'schedule', 'class', 'every', 'every_source', 'due', 'applied', 'message'], 'properties': {'due': {'type': ['object', 'null'], 'required': [], 'properties': {'done': {'type': 'integer'}, 'soon': {'type': 'boolean'}, 'basis': {'type': 'string'}, 'every': {'type': 'integer'}, 'muted': {'type': 'boolean'}, 'ratio': {'type': 'integer'}, 'state': {'type': 'string'}, 'due_at': {'type': 'string'}, 'last_at': {'type': 'string'}, 'soon_at': {'type': 'string'}, 'remaining': {'type': 'integer'}, 'overdue_at': {'type': 'string'}, 'lower_bound': {'type': 'boolean'}, 'muted_until': {'type': ['null', 'string']}, 'every_source': {'type': 'string'}}, 'additionalProperties': True}, 'task': {'type': 'string'}, 'class': {'type': 'string'}, 'every': {'type': ['object', 'null'], 'required': [], 'properties': {'days': {'type': 'integer'}, 'grams': {'type': 'integer'}, 'shots': {'type': 'integer'}, 'litres': {'type': 'number'}}, 'additionalProperties': True}, 'applied': {'type': 'boolean'}, 'message': {'type': 'string'}, 'schedule': {'type': ['object', 'null'], 'required': [], 'properties': {'every': {'type': ['object', 'null'], 'required': [], 'properties': {'days': {'type': 'integer'}, 'litres': {'type': 'number'}}, 'additionalProperties': True}, 'enabled': {'type': 'boolean'}, 'muted_until': {'type': ['null', 'string']}}, 'additionalProperties': True}, 'equipment_id': {'type': 'integer'}, 'every_source': {'type': ['object', 'null'], 'required': [], 'properties': {'days': {'type': 'string'}, 'grams': {'type': 'string'}, 'shots': {'type': 'string'}, 'litres': {'type': 'string'}}, 'additionalProperties': True}, 'equipment_kind': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['bean_id'], 'properties': {'bean_id': {'type': 'integer'}}}

{'type': 'object', 'required': ['next_step', 'category', 'warnings'], 'properties': {'category': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'next_step': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['bag_id', 'fields'], 'properties': {'bag_id': {'type': 'integer', 'description': "This account's own bag number, from list_beans' bags[]. Never guess one."}, 'fields': {'type': 'object', 'properties': {'ean': {'type': 'string'}, 'cost': {'type': 'number'}, 'state': {'enum': ['sealed', 'open', 'frozen', 'finished'], 'type': 'string'}, 'qr_code': {'type': 'string'}, 'storage': {'type': 'string'}, 'buy_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'currency': {'type': 'string'}, 'finished': {'type': 'integer', 'description': '1 if finished, 0 otherwise'}, 'bag_notes': {'type': 'string', 'maxLength': 4096}, 'frozen_at': {'type': 'string', 'description': 'Calendar day the bag went into the freezer, YYYY-MM-DD — a day, not a timestamp'}, 'roast_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'frozen_note': {'type': 'string'}, 'opened_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'unfrozen_at': {'type': 'string', 'description': 'Calendar day the bag came out, YYYY-MM-DD — a day, not a timestamp'}, 'bag_weight_g': {'type': 'number', 'description': 'Bag weight in grams'}, 'best_by_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'frozen_storage': {'type': 'string'}, 'grams_remaining': {'type': 'number', 'description': 'Override the computed grams left in the bag (weigh the bag, set what is actually there). Translated into weight_adjustment_g so bag_weight_g keeps recording the true bag size. 0 marks the bag finished; a positive value on a finished bag un-finishes it.'}, 'weight_adjustment_g': {'type': 'number', 'description': 'Grams consumed or lost OUTSIDE logged shots (spillage, unlogged brews). grams_remaining = bag_weight_g − logged doses − this. Negative adds weight back.'}}}, 'reason': {'type': 'string', 'description': "Optional free-text note, appended to this bag's notes as an ordinary line. Omit it and nothing is written."}}}

{'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['bean_id', 'fields'], 'properties': {'fields': {'type': 'object', 'properties': {'ean': {'type': 'string'}, 'url': {'type': 'string'}, 'body': {'type': 'string', 'description': 'Free text; roasters usually say low, medium or high'}, 'cost': {'type': 'number'}, 'name': {'type': 'string'}, 'notes': {'type': 'string', 'maxLength': 4096, 'description': "The coffee's own description — roaster tasting notes, the dialing approach. Replaces the stored value; the optional reason is appended instead."}, 'state': {'enum': ['sealed', 'open', 'frozen', 'finished'], 'type': 'string'}, 'origin': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 0, 'description': '1-5 stars; 0 clears the rating (unrated)'}, 'acidity': {'type': 'string', 'description': 'Free text; roasters usually say low, medium or high'}, 'co2e_kg': {'type': 'number'}, 'origins': {'type': 'array', 'items': {'type': 'object', 'properties': {'farm': {'type': 'string'}, 'farmer': {'type': 'string'}, 'region': {'type': 'string'}, 'country': {'type': 'string'}, 'harvest': {'type': 'string'}, 'variety': {'type': 'string'}, 'percentage': {'type': 'number'}, 'processing': {'type': 'string'}, 'elevation_m': {'type': 'number'}, 'elevation_max_m': {'type': 'number', 'description': 'Upper end of an elevation range; elevation_m is the lower end'}}}, 'description': 'List of bean origin details'}, 'qr_code': {'type': 'string'}, 'roaster': {'type': 'string'}, 'storage': {'type': 'string'}, 'variety': {'type': 'string'}, 'archived': {'type': 'integer', 'description': '1 if archived, 0 otherwise'}, 'bean_mix': {'type': 'string', 'description': 'E.g. blend details'}, 'buy_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'currency': {'type': 'string'}, 'finished': {'type': 'integer', 'description': '1 if finished, 0 otherwise'}, 'aromatics': {'type': 'string', 'maxLength': 1024}, 'bag_notes': {'type': 'string', 'maxLength': 4096}, 'favourite': {'type': 'integer', 'description': '1 if favourite, 0 otherwise'}, 'frozen_at': {'type': 'string', 'description': 'Calendar day the bag went into the freezer, YYYY-MM-DD — a day, not a timestamp'}, 'sweetness': {'type': 'string', 'description': 'Free text; roasters usually say low, medium or high'}, 'roast_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'arabica_pct': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'attachments': {'type': 'string', 'maxLength': 1024, 'description': 'JSON or comma-separated list of attachments'}, 'frozen_note': {'type': 'string'}, 'opened_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'roast_level': {'enum': ['ultra-light', 'light', 'medium', 'medium-dark', 'dark'], 'type': 'string'}, 'roast_range': {'type': 'string'}, 'unfrozen_at': {'type': 'string', 'description': 'Calendar day the bag came out, YYYY-MM-DD — a day, not a timestamp'}, 'bag_weight_g': {'type': 'number', 'description': 'Bag weight in grams'}, 'best_by_date': {'type': 'string', 'description': 'Calendar day in YYYY-MM-DD format — a day, not a timestamp'}, 'process_type': {'enum': ['washed', 'natural', 'honey', 'anaerobic', 'aerobic-extended', 'co-fermented', 'bioreactor', 'other'], 'type': 'string'}, 'roast_custom': {'type': 'string'}, 'decaffeinated': {'type': 'integer', 'description': '1 if decaf, 0 if regular'}, 'dial_category': {'enum': ['nordic-light', 'ultra-light', 'classic', 'processed', 'dark', 'aged'], 'type': 'string', 'description': 'Dialing behavior class: classic = medium/traditional espresso roasts (chocolate/nut, balanced); dark = genuinely dark/roasty; the light categories cover Nordic and ultra-light styles.'}, 'roasting_type': {'enum': ['filter', 'espresso', 'omni'], 'type': 'string'}, 'cupping_points': {'type': 'number'}, 'frozen_storage': {'type': 'string'}, 'grams_remaining': {'type': 'number', 'description': 'Override the computed grams left in the bag (weigh the bag, set what is actually there). Translated into weight_adjustment_g so bag_weight_g keeps recording the true bag size. 0 marks the bag finished; a positive value on a finished bag un-finishes it.'}, 'weight_adjustment_g': {'type': 'number', 'description': 'Grams consumed or lost OUTSIDE logged shots (spillage, unlogged brews). grams_remaining = bag_weight_g − logged doses − this. To force remaining to a known value X, set this to bag_weight_g − logged doses − X. Negative adds weight back.'}, 'rest_window_days_max': {'type': 'integer'}, 'rest_window_days_min': {'type': 'integer'}}}, 'reason': {'type': 'string', 'description': "Optional free-text note, appended as an ordinary line to the coffee's notes — or to the current bag's bag_notes when the call changed only bag fields. Omit it and nothing is written."}, 'bean_id': {'type': 'integer'}}}

{'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['grinder_id'], 'properties': {'fields': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'notes': {'type': ['string', 'null']}, 'photo': {'type': ['string', 'null']}, 'burr_type': {'enum': ['conical', 'flat'], 'type': 'string'}, 'max_value': {'type': ['number', 'null']}, 'min_value': {'type': ['number', 'null']}, 'catalog_id': {'type': ['string', 'null'], 'description': 'The maintenance catalog model this grinder is; "none" if it is not listed; null to unbind. list_grinders proposes one from the name under maintenance.catalog.match'}, 'motor_type': {'enum': ['manual', 'electric'], 'type': 'string'}, 'nominal_step': {'type': 'number', 'description': 'Smallest adjustment increment. On a numeric_stepless collar it is the precision labels are recorded in (0.1 records tenths) and the size of one click. numeric_stepped and clicks_single collars record whole steps whatever it says — to record tenths, set setting_scheme numeric_stepless as well'}, 'setting_scheme': {'enum': ['numeric_stepless', 'numeric_stepped', 'clicks_single', 'compound', 'named'], 'type': 'string'}, 'components_spec': {'type': ['string', 'null'], 'maxLength': 4096, 'description': 'JSON array of {name, per_step}, coarsest first — the ring arithmetic of a compound collar, or the ordered settings of a named one'}, 'microns_per_step': {'type': ['number', 'null']}, 'direction_convention': {'enum': ['lower_is_finer', 'higher_is_finer'], 'type': 'string'}}}, 'reason': {'type': 'string', 'description': "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."}, 'dry_run': {'type': 'boolean', 'description': 'true: write nothing, and answer with what the edit would do to the settings already recorded (moved[], checked, epoch, position_moved, position_cleared, rescaled_offsets, resigned_offsets, step_ignored, direction_flipped, recipe_count)'}, 'grinder_id': {'type': 'integer', 'description': "This account's own grinder number, from list_grinders. Never guess one."}}}

{'type': 'object', 'required': ['grinder_id', 'changed_keys', 'reads_changed', 'checked', 'moved_count', 'moved', 'untranslatable', 'untranslatable_recipes', 'unreadable', 'epoch', 'position_moved', 'position_cleared', 'rescaled_offsets', 'resigned_offsets', 'step_ignored', 'direction_flipped', 'recipe_count', 'status', 'dry_run', 'entry_id', 'message'], 'properties': {'epoch': {'type': 'boolean'}, 'moved': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'becomes', 'becomes_same', 'unreadable_after', 'where', 'count'], 'properties': {'count': {'type': 'integer'}, 'label': {'type': 'string'}, 'where': {'type': 'string'}, 'becomes': {'type': 'string'}, 'becomes_same': {'type': 'boolean'}, 'unreadable_after': {'type': 'boolean'}}, 'additionalProperties': True}}, 'status': {'type': 'string'}, 'checked': {'type': ['integer', 'null']}, 'dry_run': {'type': 'boolean'}, 'message': {'type': 'string'}, 'entry_id': {'type': ['null', 'integer']}, 'grinder_id': {'type': 'integer'}, 'unreadable': {'type': ['integer', 'null']}, 'moved_count': {'type': ['integer', 'null']}, 'changed_keys': {'type': 'array', 'items': {'type': 'string'}}, 'recipe_count': {'type': ['integer', 'null']}, 'step_ignored': {'type': 'boolean'}, 'reads_changed': {'type': 'boolean'}, 'position_moved': {'type': 'boolean'}, 'untranslatable': {'type': ['integer', 'null']}, 'position_cleared': {'type': 'boolean'}, 'rescaled_offsets': {'type': 'integer'}, 'resigned_offsets': {'type': 'integer'}, 'direction_flipped': {'type': 'boolean'}, 'untranslatable_recipes': {'type': ['integer', 'null']}}, 'additionalProperties': True}

{'type': 'object', 'required': ['machine_id'], 'properties': {'fields': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'notes': {'type': ['string', 'null']}, 'photo': {'type': ['string', 'null']}, 'tools': {'type': ['string', 'null'], 'description': 'Comma-separated accessories. list_machines reads them back as tools_list'}, 'prep_type': {'type': 'string', 'description': 'One of: espresso_machine, lever_press, moka_pot, aeropress, french_press, v60_dripper, cold_brew.'}, 'catalog_id': {'type': ['string', 'null'], 'description': 'The maintenance catalog model this machine is; "none" if it is not listed; null to unbind. list_machines proposes one from the name under maintenance.catalog.match'}, 'prep_style': {'type': 'string', 'description': 'One of: espresso, filter, immersion, percolation. Only "espresso" is diagnosed by the dialing engine (G8).'}, 'boiler_type': {'type': ['string', 'null']}, 'hardness_dh': {'type': ['number', 'null'], 'description': 'The total hardness (GH) of the water this machine runs on, in °dH; null to fall back to the water of its last shot'}, 'control_type': {'enum': ['volumetric', 'manual', 'lever'], 'type': 'string'}, 'connected_device': {'type': ['string', 'null']}, 'basket_size_grams': {'type': ['number', 'null']}}}, 'reason': {'type': 'string', 'description': "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."}, 'machine_id': {'type': 'integer', 'description': "This account's own machine number, from list_machines. Never guess one."}}}

{'type': 'object', 'required': ['status', 'machine_id', 'changed_keys', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'machine_id': {'type': 'integer'}, 'changed_keys': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}

{'type': 'object', 'required': ['scale_id'], 'properties': {'fields': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'notes': {'type': ['string', 'null']}, 'power': {'enum': ['usb_c', 'micro_usb', 'aa', 'aaa', 'mains', None], 'type': ['string', 'null']}, 'depth_mm': {'type': ['number', 'null']}, 'width_mm': {'type': ['number', 'null']}, 'auto_tare': {'type': ['integer', 'null']}, 'height_mm': {'type': ['number', 'null']}, 'auto_timer': {'type': ['integer', 'null']}, 'capacity_g': {'type': ['number', 'null']}, 'scale_type': {'enum': ['espresso', 'brew', 'dual', 'connected', 'dosing', 'training', 'bench'], 'type': 'string'}, 'connectivity': {'enum': ['none', 'bluetooth', 'usb', 'bluetooth_usb', None], 'type': ['string', 'null']}, 'resolution_g': {'type': ['number', 'null']}, 'water_resistance': {'type': ['string', 'null']}, 'flow_rate_display': {'type': ['integer', 'null']}, 'resolution_banded': {'type': ['integer', 'null'], 'description': '1 when resolution_g only holds in the lowest weight band'}}}, 'reason': {'type': 'string', 'description': "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."}, 'scale_id': {'type': 'integer', 'description': "This account's own scale number, from list_scales. Never guess one."}}}

{'type': 'object', 'required': ['status', 'scale_id', 'changed_keys', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'scale_id': {'type': 'integer'}, 'changed_keys': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}

{'type': 'object', 'required': ['shot_id', 'fields'], 'properties': {'fields': {'type': 'object', 'properties': {'tds': {'type': 'number'}, 'bag_id': {'type': 'integer', 'description': "Re-file the shot onto this bag; must be a bag of the shot's bean"}, 'dose_g': {'type': 'number'}, 'rating': {'type': ['integer', 'null'], 'maximum': 5, 'minimum': 1, 'description': '1-5; null clears the rating'}, 'tasted': {'enum': [0, 1], 'type': 'integer', 'description': 'Backfill 1 to mark a pending shot as tasted-clean (tasted, no defect tags) so it leaves the taste-pending queue without inventing a tag or rating'}, 'time_s': {'type': 'number'}, 'bean_id': {'type': 'integer', 'description': 'Re-file the shot onto this bean (its current bag, unless bag_id is also given)'}, 'verdict': {'type': ['string', 'null'], 'description': 'null clears the verdict'}, 'yield_g': {'type': 'number'}, 'water_id': {'type': 'integer'}, 'best_brew': {'enum': [0, 1], 'type': 'integer'}, 'favourite': {'enum': [0, 1], 'type': 'integer'}, 'pulled_at': {'type': 'string', 'description': 'Corrected timestamp (ISO 8601 or "YYYY-MM-DD HH:MM:SS")'}, 'beverage_g': {'type': 'number'}, 'grinder_id': {'type': 'integer'}, 'machine_id': {'type': 'integer'}, 'program_id': {'type': 'integer'}, 'temp_taste': {'enum': ['hot', 'warm', 'cold'], 'type': 'string'}, 'grind_label': {'type': 'string', 'description': 'Corrected grind setting label; numeric position is re-derived'}, 'vessel_name': {'type': 'string'}, 'drink_intent': {'enum': ['straight', 'milk'], 'type': 'string'}, 'flavor_notes': {'type': ['string', 'null'], 'maxLength': 4096, 'description': 'null clears the notes'}, 'observations': {'type': 'object', 'maxProperties': 64}, 'sensory_tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 64}, 'finish_action': {'enum': ['hard_stop', 'passive_drip'], 'type': 'string'}, 'temperature_c': {'type': 'number'}, 'data_confidence': {'enum': ['measured', 'recalled', 'estimated'], 'type': 'string', 'description': 'estimated marks the metrics as a best guess instead of burying the caveat in notes'}, 'vessel_weight_g': {'type': 'number'}}, 'description': 'Only the fields to change'}, 'shot_id': {'type': 'integer', 'description': 'ID of the shot to correct'}}}

{'type': 'object', 'required': ['status', 'shot_id', 'updated_fields', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'shot_id': {'type': 'integer'}, 'updated_fields': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}

{'type': 'object', 'required': ['water_id'], 'properties': {'fields': {'type': 'object', 'properties': {'gh': {'type': ['number', 'null']}, 'kh': {'type': ['number', 'null']}, 'tds': {'type': ['number', 'null']}, 'name': {'type': 'string'}, 'type': {'type': ['string', 'null']}, 'notes': {'type': ['string', 'null']}, 'sodium': {'type': ['number', 'null']}, 'calcium': {'type': ['number', 'null']}, 'magnesium': {'type': ['number', 'null']}}}, 'reason': {'type': 'string', 'description': "Optional note, appended to this record's own notes as an ordinary line. Omit it and nothing is written."}, 'water_id': {'type': 'integer', 'description': "This account's own water number, from list_waters. Never guess one."}}}

{'type': 'object', 'required': ['status', 'water_id', 'changed_keys', 'message'], 'properties': {'status': {'type': 'string'}, 'message': {'type': 'string'}, 'water_id': {'type': 'integer'}, 'changed_keys': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}