Last Price

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

{'type': 'object', 'required': ['currency'], 'properties': {'geo': {'type': 'string', 'description': 'Optional geography hint, e.g. US.'}, 'currency': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': 'Three-letter ISO currency code, e.g. USD.'}, 'metadata': {'type': 'object', 'description': 'Optional context. For competitive pricing: competitor_price, competitor_currency and competitive_action (match or undercut); undercut requires undercut_pct. Confirm product comparability before calling.'}, 'max_price': {'type': 'number', 'minimum': 0, 'description': 'Optional maximum acceptable price.'}, 'min_price': {'type': 'number', 'minimum': 0, 'description': 'Optional minimum acceptable price. A competitive offer needs this or a declared unit_cost and target_margin_pct.'}, 'unit_cost': {'type': 'number', 'minimum': 0, 'description': 'What the work costs you. It lets lastprice/cost-plus price with no current_price, which is the usual case when pricing a task you are about to run. Routing picks a function that can use it; to require cost-plus, pass its UUID from list_functions as function_id.'}, 'product_id': {'type': 'string', 'description': 'Optional identifier of what is being priced.'}, 'function_id': {'type': 'string', 'format': 'uuid', 'description': 'Optional explicit pricing function UUID to use.'}, 'product_type': {'enum': ['saas', 'ecommerce', 'marketplace', 'digital', 'api', 'custom'], 'type': 'string', 'description': 'Optional category. Defaults to "custom".'}, 'current_price': {'type': 'number', 'minimum': 0, 'description': 'The current or reference price. Optional: functions that price relative to an incumbent need it, but lastprice/cost-plus prices from unit_cost instead.'}, 'customer_segment': {'type': 'string', 'description': 'Optional segment, e.g. enterprise.'}, 'target_margin_pct': {'type': 'number', 'maximum': 95, 'minimum': 0, 'description': 'Margin on price for cost-plus, not markup on cost: price = unit_cost / (1 - margin). Defaults to 30.'}, 'routing_preference': {'enum': ['cheapest', 'fastest', 'explicit', 'round_robin', 'weighted', 'policy', 'default'], 'type': 'string', 'description': 'How to route across pricing functions. Defaults to "default".'}, 'include_explanation': {'type': 'boolean', 'description': 'If true, ask for an explanation and confidence with the price.'}}}

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

{'type': 'object', 'properties': {'action': {'enum': ['prepare', 'compute'], 'type': 'string', 'default': 'prepare'}, 'answers': {'type': 'object', 'properties': {'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'max_price': {'type': 'number', 'minimum': 0}, 'min_price': {'type': 'number', 'minimum': 0}, 'unit_cost': {'type': 'number', 'minimum': 0}, 'current_price': {'type': 'number', 'minimum': 0}, 'target_margin_pct': {'type': 'number', 'maximum': 95, 'minimum': 0}}, 'additionalProperties': False}, 'request': {'type': 'object', 'description': 'Partial REST PricingComputeRequest, including nested context, constraints, an explicit function selection and options. Reuse continuation.request on subsequent calls.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['proposed_price'], 'properties': {'geo': {'type': 'string', 'description': 'Optional geography hint, e.g. US.'}, 'currency': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': 'Three-letter ISO currency code, e.g. USD. Defaults to USD.'}, 'metadata': {'type': 'object', 'description': 'Optional free-form context.'}, 'max_price': {'type': 'number', 'minimum': 0, 'description': 'Optional hard ceiling. Binding: a verdict will never relax it.'}, 'min_price': {'type': 'number', 'minimum': 0, 'description': 'Optional hard floor. Binding: a verdict will never relax it.'}, 'product_id': {'type': 'string', 'description': 'Optional identifier of what is being priced.'}, 'product_type': {'enum': ['saas', 'ecommerce', 'marketplace', 'digital', 'api', 'custom'], 'type': 'string', 'description': 'Optional category of what is being priced.'}, 'current_price': {'type': 'number', 'minimum': 0, 'description': 'Optional incumbent price. Not required: asking whether a price is sensible does not presuppose an existing one.'}, 'proposed_price': {'type': 'number', 'minimum': 0, 'description': 'The price to judge. This is the subject of the call.'}, 'customer_segment': {'type': 'string', 'description': 'Optional segment, e.g. enterprise.'}}}