Attach Meter to Plan
Attaches a meter to an existing plan as a metered price: included credits per cycle plus the price per unit beyond them.
403 PRODUCT_NOT_ENABLED.- On creation: pass
meters[](same shape as this request body) to Create Plan. Duplicatedmeter_identries are rejected with409. - On a live plan: call this endpoint once per meter, or send
{ "meters": [ ... ] }toPATCH /subscriptions/plans/{plan_id}— that PATCH is attach-only and atomic: if any entry in the list is invalid (already attached, unknown or inactive meter, bad price) nothing is attached. Any other plan field in that body (name,base_amount, …) is silently ignored — plans stay immutable outsidemeters[].
USD and the meter has a default_price, you can omit price_per_credit: the meter’s default applies and the metered price is returned with price_per_credit: null. In any other case (price_per_credit currency must always equal the plan’s base currency) send it explicitly. Only ACTIVE meters can be attached; an archived meter is rejected with 400 METER_NOT_FOUND.pricing_strategy configPER_UNIT uses price_per_credit/country_prices. PACKAGE uses package_size, package_price and optionally package_country_prices. TIERED uses tiers[] (ascending up_to bounds, last tier up_to: null). Sending config fields for a strategy other than the one you selected is rejected with 400 PLAN_METER_PRICING_CONFIG_UNSUPPORTED. Once attached, PACKAGE/TIERED config cannot be changed — see Update Plan Meter.Authorizations
Headers
The account_id found in your Yuno Dashboard (UUID). Required — omitting it returns 400 BAD_REQUEST ("Invalid x-account-code header.").
Body
Only for pricing_strategy: PACKAGE. The bundle size — billable units are rounded up to the nearest whole multiple. Must be > 0; decimals and scientific notation (1e3) are accepted and coerced. Stored rounded to 4 decimal places. Required when pricing_strategy is PACKAGE; rejected with 400 PLAN_METER_PRICING_CONFIG_UNSUPPORTED for any other strategy.
Only for pricing_strategy: TIERED. Ordered, graduated pricing bands. Required when pricing_strategy is TIERED (at least one entry). Every tier but the last needs a strictly-ascending up_to; the last tier's up_to must be null (unbounded). Every tier must share the same currency (and the same country_rates countries, if used).
Response
201