API Reference

Update Price

Update a price. Body is application/x-www-form-urlencoded (ADR 0004); merchant-scoped through the Fluveo /v1 tenant wrapper.

Authentication

AuthorizationBasic

Standard Basic HTTP authentication. The username is the Fluveo secret key and the password must be empty, encoded as base64(api_key:).

OR
AuthorizationBearer

Bearer HTTP authentication. Allowed header: Authorization: Bearer <api_key>.

Path parameters

pricestringRequiredformat: "^price_"

Headers

Idempotency-KeystringOptional1-255 characters

Makes a POST safely retryable according to that operation’s documented idempotency policy. The durable 24-hour journal applies only where the resource documentation explicitly claims it. Reusing a key with different parameters or another endpoint returns an idempotency error.

Request

This endpoint expects an object.
activebooleanOptional
lookup_keystringOptional
metadatamap from strings to stringsOptional

Stripe-compatible public metadata: at most 50 merchant-visible entries, with keys up to 40 characters and string values up to 500 characters. Server-owned fluveo_ stamps are not part of the public allowance and are never returned.

nicknamestringOptional
tax_behaviorenumOptional
Allowed values:
transfer_lookup_keybooleanOptional
Move the lookup key from the price that currently holds it.

Response

Stripe-compatible response

activeboolean
currencystringformat: "^[a-z]{3}$"
idstringformat: "^price_"<=5000 characters

Fluveo narrowing: not in upstream pin; truthful public id-prefix constraint

objectenum
Allowed values:
productstring<=5000 characters
recurringobject
unit_amountinteger

Per-unit price in the smallest currency unit.

billing_schemeenumOptional
Allowed values:
createdintegerOptional
custom_unit_amountobject or nullOptional
livemodebooleanOptional
lookup_keystring or nullOptional<=5000 characters
metadatamap from strings to stringsOptional
nicknamestring or nullOptional<=5000 characters
tax_behaviorenum or nullOptional
Allowed values:
tiers_modeenum or nullOptional
Allowed values:
transform_quantityobject or nullOptional
typeenumOptional
Allowed values:
unit_amount_decimalstring or nullOptionalformat: "decimal"