{"openapi":"3.1.0","info":{"title":"Meridary Agent API","version":"1.0.0","description":"Agent-only financial planning API. Agent purchases and data do not grant or enter the web planner."},"servers":[{"url":"https://www.meridary.com"}],"paths":{"/api/v1/calculators/rmd":{"post":{"operationId":"calculateRmd","x-meridary-tool":"calculate_rmd","summary":"Calculate a 2026 required minimum distribution","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prior_year_end_balance_cents":{"type":"integer","minimum":0,"maximum":100000000000000},"age":{"type":"integer","minimum":18,"maximum":120},"birth_year":{"type":"integer","minimum":1900,"maximum":2100},"law_version":{"type":"number","const":2026}},"required":["prior_year_end_balance_cents","age","birth_year"],"additionalProperties":false}}}},"responses":{"200":{"description":"Sourced RMD result; costs 0 units","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"rmd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"divisor":{"type":"number"},"beginning_age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_required":{"type":"boolean"},"law_version":{"type":"number","const":2026},"methodology":{"type":"object","properties":{"rounding":{"type":"string","const":"nearest_cent"},"source":{"type":"string"},"source_url":{"type":"string","format":"uri"}},"required":["rounding","source","source_url"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"number","const":0}},"required":["units_charged"],"additionalProperties":false}},"required":["rmd_cents","divisor","beginning_age","is_required","law_version","methodology","usage"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}}},"/api/v1/calculators/retirement-readiness":{"post":{"operationId":"assessRetirementReadiness","x-meridary-tool":"assess_retirement_readiness","security":[{"agentOAuth":[]}],"summary":"Run a free stateless retirement-readiness assessment","responses":{"200":{"description":"Bounded 250-trial assessment","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"target_retirement_age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"modeled_through_age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"success_probability":{"type":"number","minimum":0,"maximum":1},"success_probability_interval":{"type":"object","properties":{"lower":{"type":"number","minimum":0,"maximum":1},"upper":{"type":"number","minimum":0,"maximum":1},"confidence":{"type":"number","const":0.95},"method":{"type":"string","const":"wilson_score"}},"required":["lower","upper","confidence","method"],"additionalProperties":false},"deterministic_final_assets_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_modeled_shortfall":{"anyOf":[{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":false},{"type":"null"}]},"median_failure_age":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"applied_defaults":{"type":"array","items":{"type":"string"}},"assumptions":{"type":"object","properties":{"trials":{"type":"number","const":250},"seed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"as_of_year":{"type":"number","const":2026},"investment_return_rate":{"type":"number"},"cash_interest_rate":{"type":"number"},"dividend_yield":{"type":"number"},"inflation_rate":{"type":"number"},"rule_year":{"type":"number","const":2026}},"required":["trials","seed","as_of_year","investment_return_rate","cash_interest_rate","dividend_yield","inflation_rate","rule_year"],"additionalProperties":false},"limitations":{"minItems":1,"type":"array","items":{"type":"string"}},"usage":{"type":"object","properties":{"units_charged":{"type":"number","const":0}},"required":["units_charged"],"additionalProperties":false}},"required":["target_retirement_age","modeled_through_age","success_probability","success_probability_interval","deterministic_final_assets_cents","first_modeled_shortfall","median_failure_age","applied_defaults","assumptions","limitations","usage"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"400":{"description":"Invalid assessment input","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"target_retirement_age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"modeled_through_age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"success_probability":{"type":"number","minimum":0,"maximum":1},"success_probability_interval":{"type":"object","properties":{"lower":{"type":"number","minimum":0,"maximum":1},"upper":{"type":"number","minimum":0,"maximum":1},"confidence":{"type":"number","const":0.95},"method":{"type":"string","const":"wilson_score"}},"required":["lower","upper","confidence","method"],"additionalProperties":false},"deterministic_final_assets_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_modeled_shortfall":{"anyOf":[{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":false},{"type":"null"}]},"median_failure_age":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"applied_defaults":{"type":"array","items":{"type":"string"}},"assumptions":{"type":"object","properties":{"trials":{"type":"number","const":250},"seed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"as_of_year":{"type":"number","const":2026},"investment_return_rate":{"type":"number"},"cash_interest_rate":{"type":"number"},"dividend_yield":{"type":"number"},"inflation_rate":{"type":"number"},"rule_year":{"type":"number","const":2026}},"required":["trials","seed","as_of_year","investment_return_rate","cash_interest_rate","dividend_yield","inflation_rate","rule_year"],"additionalProperties":false},"limitations":{"minItems":1,"type":"array","items":{"type":"string"}},"usage":{"type":"object","properties":{"units_charged":{"type":"number","const":0}},"required":["units_charged"],"additionalProperties":false}},"required":["target_retirement_age","modeled_through_age","success_probability","success_probability_interval","deterministic_final_assets_cents","first_modeled_shortfall","median_failure_age","applied_defaults","assumptions","limitations","usage"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"429":{"description":"Compute admission denied","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"target_retirement_age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"modeled_through_age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"success_probability":{"type":"number","minimum":0,"maximum":1},"success_probability_interval":{"type":"object","properties":{"lower":{"type":"number","minimum":0,"maximum":1},"upper":{"type":"number","minimum":0,"maximum":1},"confidence":{"type":"number","const":0.95},"method":{"type":"string","const":"wilson_score"}},"required":["lower","upper","confidence","method"],"additionalProperties":false},"deterministic_final_assets_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_modeled_shortfall":{"anyOf":[{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":false},{"type":"null"}]},"median_failure_age":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"applied_defaults":{"type":"array","items":{"type":"string"}},"assumptions":{"type":"object","properties":{"trials":{"type":"number","const":250},"seed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"as_of_year":{"type":"number","const":2026},"investment_return_rate":{"type":"number"},"cash_interest_rate":{"type":"number"},"dividend_yield":{"type":"number"},"inflation_rate":{"type":"number"},"rule_year":{"type":"number","const":2026}},"required":["trials","seed","as_of_year","investment_return_rate","cash_interest_rate","dividend_yield","inflation_rate","rule_year"],"additionalProperties":false},"limitations":{"minItems":1,"type":"array","items":{"type":"string"}},"usage":{"type":"object","properties":{"units_charged":{"type":"number","const":0}},"required":["units_charged"],"additionalProperties":false}},"required":["target_retirement_age","modeled_through_age","success_probability","success_probability_interval","deterministic_final_assets_cents","first_modeled_shortfall","median_failure_age","applied_defaults","assumptions","limitations","usage"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"as_of_year":{"type":"number","const":2026},"filing_status":{"type":"string","enum":["single","married_joint"]},"current_age":{"type":"integer","minimum":18,"maximum":90},"partner_age":{"type":"integer","minimum":18,"maximum":100},"annual_income_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"partner_annual_income_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"savings":{"type":"object","properties":{"cash_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"taxable_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"traditional_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"roth_cents":{"type":"number","minimum":0,"maximum":1000000000000000}},"additionalProperties":false},"annual_contribution_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"retirement_age":{"type":"integer","minimum":18,"maximum":100},"final_age":{"type":"integer","minimum":19,"maximum":120},"annual_retirement_spending_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"social_security_annual_benefit_cents":{"type":"number","minimum":0,"maximum":1000000000000000},"social_security_claim_age":{"type":"integer","minimum":62,"maximum":70}},"required":["current_age","annual_income_cents","savings","retirement_age","annual_retirement_spending_cents"],"additionalProperties":false}}}}}},"/api/v1/agent/offer":{"get":{"operationId":"getAgentOffer","x-meridary-tool":"meridary_offer","summary":"Get Agent subscription and prepaid-unit terms","responses":{"200":{"description":"Current public offer","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"product":{"type":"string"},"sku":{"type":"string"},"price":{"type":"object","properties":{"amount_cents":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"currency":{"type":"string"},"cadence":{"type":"string"}},"required":["amount_cents","currency","cadence"],"additionalProperties":false},"units":{"type":"object","properties":{},"additionalProperties":{}},"operations":{"type":"object","properties":{"projection":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"comparison":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retirement_age":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["projection","comparison","retirement_age"],"additionalProperties":false}},"required":["product","sku","price","units","operations"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}}},"/api/v1/agent/access":{"get":{"operationId":"getAgentAccess","x-meridary-tool":"meridary_access","security":[{"agentOAuth":[]}],"summary":"Get Agent subscription and unit balance","responses":{"200":{"description":"Agent-only access status","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string"},"balance":{"type":"integer","minimum":0,"maximum":9007199254740991},"renewsOrEndsAt":{"type":["string","null"]},"cancelAtPeriodEnd":{"type":"boolean"}},"required":["status","balance","renewsOrEndsAt","cancelAtPeriodEnd"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}}},"/api/v1/agent/checkout":{"post":{"operationId":"startAgentCheckout","x-meridary-tool":"meridary_start_checkout","security":[{"agentOAuth":["agent:checkout"]}],"summary":"Create Agent subscription checkout","responses":{"200":{"description":"Stripe-hosted checkout URL","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string"},"checkout_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["status","checkout_url"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}}},"/api/v1/agent/current-finances":{"get":{"operationId":"getAgentCurrentFinances","x-meridary-tool":"get_current_finances","security":[{"agentOAuth":["agent:plans:read"]}],"summary":"Read Agent Current Finances","responses":{"200":{"description":"Agent profile","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"asOfYear":{"type":"integer","minimum":1900,"maximum":2026},"primary":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"partner":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["asOfYear","primary","accounts","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}},"put":{"operationId":"setAgentCurrentFinances","x-meridary-tool":"set_current_finances","security":[{"agentOAuth":["agent:plans:write"]}],"summary":"Save Agent Current Finances","responses":{"200":{"description":"Saved profile","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"asOfYear":{"type":"integer","minimum":1900,"maximum":2026},"primary":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"partner":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["asOfYear","primary","accounts","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"400":{"description":"Invalid profile","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"asOfYear":{"type":"integer","minimum":1900,"maximum":2026},"primary":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"partner":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["asOfYear","primary","accounts","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"409":{"description":"Version conflict","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"asOfYear":{"type":"integer","minimum":1900,"maximum":2026},"primary":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"partner":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["asOfYear","primary","accounts","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"parameters":[{"name":"X-Agent-Profile-Updated-At","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"asOfYear":{"type":"integer","minimum":1900,"maximum":2026},"primary":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"partner":{"type":"object","properties":{"birthYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["birthYear","annualWagesCents"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["asOfYear","primary","accounts"],"additionalProperties":false}},"required":["profile"],"additionalProperties":false}}}}},"delete":{"operationId":"deleteAgentCurrentFinances","x-meridary-tool":"delete_current_finances","security":[{"agentOAuth":["agent:plans:write"]}],"summary":"Delete Agent Current Finances and saved plans","responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"boolean"},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}}},"/api/v1/agent/account":{"delete":{"operationId":"deleteAgentAccount","x-meridary-tool":"delete_agent_account","security":[{"agentOAuth":["agent:account:delete"]}],"summary":"Cancel billing and delete all Agent product data","responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"boolean"},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}}},"/api/v1/agent/plans":{"get":{"operationId":"listAgentPlans","x-meridary-tool":"list_plans","security":[{"agentOAuth":["agent:plans:read"]}],"summary":"List Agent plans","responses":{"200":{"description":"Agent plans","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false}},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}}},"post":{"operationId":"createAgentPlan","x-meridary-tool":"create_plan","security":[{"agentOAuth":["agent:plans:write"]}],"summary":"Create an Agent plan","responses":{"201":{"description":"Created plan","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"400":{"description":"Invalid plan","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"409":{"description":"Plan limit","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"name":{"type":"string"}},"required":["inputs"],"additionalProperties":false}}}}}},"/api/v1/agent/plans/{id}":{"get":{"operationId":"getAgentPlan","x-meridary-tool":"get_plan","security":[{"agentOAuth":["agent:plans:read"]}],"summary":"Read an Agent plan","responses":{"200":{"description":"Agent plan","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}]},"patch":{"operationId":"updateAgentPlan","x-meridary-tool":"update_plan","security":[{"agentOAuth":["agent:plans:write"]}],"summary":"Update an Agent plan","responses":{"200":{"description":"Updated plan","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"400":{"description":"Invalid plan","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"409":{"description":"Version conflict","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":["string","null"]},"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"schemaVersion":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","inputs","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"X-Agent-Plan-Updated-At","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"type":"object","properties":{"household":{"type":"object","properties":{"filingStatus":{"type":"string","enum":["single","marriedJoint"]},"birthYear":{"type":"number"},"currentAge":{"type":"integer","minimum":18,"maximum":100},"finalAge":{"type":"integer","minimum":19,"maximum":120},"asOfYear":{"type":"integer","minimum":1900,"maximum":2200},"annualWagesCents":{"type":"number","minimum":0,"maximum":1000000000000000},"socialSecurity":{"type":"object","properties":{"annualBenefitCents":{"type":"number","minimum":0,"maximum":1000000000000000},"claimAge":{"type":"integer","minimum":62,"maximum":70}},"required":["annualBenefitCents","claimAge"],"additionalProperties":{}},"accounts":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["529","cash","taxableBrokerage","traditional","roth","hsa"]},"balanceCents":{"type":"number","minimum":0,"maximum":1000000000000000},"costBasisCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["type","balanceCents"],"additionalProperties":{}}}},"required":["filingStatus","birthYear","currentAge","finalAge","annualWagesCents","socialSecurity","accounts"],"additionalProperties":{}},"assumptions":{"type":"object","properties":{"investmentReturnRate":{"type":"number","minimum":0,"maximum":0.25},"cashInterestRate":{"type":"number","minimum":0,"maximum":0.25},"dividendYield":{"type":"number","minimum":0,"maximum":0.25},"inflationRate":{"type":"number","minimum":0,"maximum":0.25},"retirementAge":{"type":"integer","minimum":0,"maximum":120},"retirementAnnualSpendingCents":{"type":"number","minimum":0,"maximum":1000000000000000}},"required":["investmentReturnRate","cashInterestRate","dividendYield","inflationRate","retirementAge","retirementAnnualSpendingCents"],"additionalProperties":{}},"seed":{"type":"integer","minimum":0,"maximum":4294967295},"monteCarlo":{"type":"object","properties":{},"additionalProperties":{}}},"required":["household","assumptions","seed"],"additionalProperties":{}},"name":{"type":["string","null"]}},"additionalProperties":false}}}}},"delete":{"operationId":"deleteAgentPlan","x-meridary-tool":"delete_plan","security":[{"agentOAuth":["agent:plans:write"]}],"summary":"Delete an Agent plan","responses":{"204":{"description":"Deleted"},"404":{"description":"Not found","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"boolean"},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}]}},"/api/v1/agent/analyses/projection":{"post":{"operationId":"runAgentProjection","x-meridary-tool":"run_projection","security":[{"agentOAuth":["agent:analysis"]}],"summary":"Run a paid projection","responses":{"200":{"description":"Projection; one unit","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"projection":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":{}}},"monte_carlo":{"anyOf":[{"type":"object","properties":{"trials":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"successes":{"type":"integer","minimum":0,"maximum":9007199254740991},"successProbability":{"type":"number","minimum":0,"maximum":1}},"required":["trials","successes","successProbability"],"additionalProperties":{}},{"type":"null"}]},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["projection","monte_carlo","methodology"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"402":{"description":"Payment or quota required","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"projection":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":{}}},"monte_carlo":{"anyOf":[{"type":"object","properties":{"trials":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"successes":{"type":"integer","minimum":0,"maximum":9007199254740991},"successProbability":{"type":"number","minimum":0,"maximum":1}},"required":["trials","successes","successProbability"],"additionalProperties":{}},{"type":"null"}]},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["projection","monte_carlo","methodology"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan_id":{"type":"string","minLength":1},"monte_carlo":{"type":"object","properties":{"trials":{"type":"integer","minimum":1,"maximum":1000},"volatility":{"type":"number","minimum":0}},"additionalProperties":false}},"required":["plan_id"],"additionalProperties":false}}}}}},"/api/v1/agent/analyses/compare":{"post":{"operationId":"compareAgentPlans","x-meridary-tool":"compare_plans","security":[{"agentOAuth":["agent:analysis"]}],"summary":"Compare two paid plans","responses":{"200":{"description":"Comparison; two units","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"plans":{"type":"array","prefixItems":[{"type":"object","properties":{"projection":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":{}}},"monte_carlo":{"anyOf":[{"type":"object","properties":{"trials":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"successes":{"type":"integer","minimum":0,"maximum":9007199254740991},"successProbability":{"type":"number","minimum":0,"maximum":1}},"required":["trials","successes","successProbability"],"additionalProperties":{}},{"type":"null"}]},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["projection","monte_carlo","methodology"],"additionalProperties":false},{"type":"object","properties":{"projection":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":{}}},"monte_carlo":{"anyOf":[{"type":"object","properties":{"trials":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"successes":{"type":"integer","minimum":0,"maximum":9007199254740991},"successProbability":{"type":"number","minimum":0,"maximum":1}},"required":["trials","successes","successProbability"],"additionalProperties":{}},{"type":"null"}]},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["projection","monte_carlo","methodology"],"additionalProperties":false}],"items":false,"minItems":2,"maxItems":2},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["plans","methodology"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"402":{"description":"Payment or quota required","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"plans":{"type":"array","prefixItems":[{"type":"object","properties":{"projection":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":{}}},"monte_carlo":{"anyOf":[{"type":"object","properties":{"trials":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"successes":{"type":"integer","minimum":0,"maximum":9007199254740991},"successProbability":{"type":"number","minimum":0,"maximum":1}},"required":["trials","successes","successProbability"],"additionalProperties":{}},{"type":"null"}]},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["projection","monte_carlo","methodology"],"additionalProperties":false},{"type":"object","properties":{"projection":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"age":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["year","age"],"additionalProperties":{}}},"monte_carlo":{"anyOf":[{"type":"object","properties":{"trials":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"successes":{"type":"integer","minimum":0,"maximum":9007199254740991},"successProbability":{"type":"number","minimum":0,"maximum":1}},"required":["trials","successes","successProbability"],"additionalProperties":{}},{"type":"null"}]},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["projection","monte_carlo","methodology"],"additionalProperties":false}],"items":false,"minItems":2,"maxItems":2},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["plans","methodology"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan_ids":{"type":"array","prefixItems":[{"type":"string","minLength":1},{"type":"string","minLength":1}],"items":false,"minItems":2,"maxItems":2},"monte_carlo":{"type":"object","properties":{"trials":{"type":"integer","minimum":1,"maximum":500},"volatility":{"type":"number","minimum":0}},"additionalProperties":false}},"required":["plan_ids"],"additionalProperties":false}}}}}},"/api/v1/agent/analyses/retirement-age":{"post":{"operationId":"findAgentRetirementAge","x-meridary-tool":"find_earliest_retirement_age","security":[{"agentOAuth":["agent:analysis"]}],"summary":"Find earliest retirement age","responses":{"200":{"description":"Retirement age; five units","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"retirement_age":{"type":"object","properties":{"targetProbability":{"type":"number","minimum":0,"maximum":1},"retirementAge":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"achievedProbability":{"type":"number","minimum":0,"maximum":1},"targetMet":{"type":"boolean"}},"required":["targetProbability","retirementAge","achievedProbability","targetMet"],"additionalProperties":{}},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["retirement_age","methodology"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}},"402":{"description":"Payment or quota required","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"retirement_age":{"type":"object","properties":{"targetProbability":{"type":"number","minimum":0,"maximum":1},"retirementAge":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"achievedProbability":{"type":"number","minimum":0,"maximum":1},"targetMet":{"type":"boolean"}},"required":["targetProbability","retirementAge","achievedProbability","targetMet"],"additionalProperties":{}},"methodology":{"type":"object","properties":{},"additionalProperties":{}}},"required":["retirement_age","methodology"],"additionalProperties":false},"usage":{"type":"object","properties":{"units_charged":{"type":"integer","minimum":0,"maximum":9007199254740991},"units_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"idempotent_replay":{"type":"boolean"}},"required":["units_charged","units_remaining","idempotent_replay"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_token","invalid_payload","conflict","not_found","profile_required","idempotency_required","payment_required","quota_exhausted","idempotency_conflict","idempotency_source_changed","in_progress","previous_attempt_failed","analysis_failed","analysis_unavailable","rate_limited","capacity_unavailable","agent_access_unavailable","us_only","identity_not_found","checkout_unavailable","host_capability_denied","insufficient_scope","operation_failed","unknown_tool"]},"message":{"type":"string","minLength":1}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}]}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan_id":{"type":"string","minLength":1},"target_probability":{"type":"number","minimum":0.5,"maximum":0.99},"intermediate_trials":{"type":"integer","minimum":1,"maximum":500},"final_trials":{"type":"integer","minimum":1,"maximum":1000},"max_iterations":{"type":"integer","minimum":1,"maximum":32}},"required":["plan_id","target_probability"],"additionalProperties":false}}}}}}},"components":{"securitySchemes":{"agentOAuth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://www.meridary.com/api/auth/oauth2/authorize","tokenUrl":"https://www.meridary.com/api/auth/oauth2/token","scopes":{"openid":"Identify the account","offline_access":"Refresh access without another browser handoff","agent:plans:read":"Read agent-only plans","agent:plans:write":"Write agent-only plans","agent:account:delete":"Cancel billing and permanently delete Agent data","agent:analysis":"Run prepaid analyses","agent:checkout":"Create a hosted checkout URL"}}}}}},"externalDocs":{"url":"https://www.meridary.com/developers/agents"}}