Versioning

The API is versioned in the path (/v1). Additive changes (new fields, new endpoints, new enum values on fields documented as open) ship without a version bump; treat unknown fields as ignorable and unknown enum values as pass-through. Breaking changes ship as a new version with at least 12 months of overlap, announced in the changelog and flagged with Sunset headers on the old version. A machine-readable changelog publishes with the first post-GA change; until then, this page is the contract.

Before GA. VAMOS has not reached GA. Until it does, /v1 is a preview contract: a correction to it ships in place, dated and listed below, rather than as a new version. The 12-month overlap and Sunset guarantee above attaches at GA, when there is a production contract worth guaranteeing. Every in-place correction is listed here, so a partner reading this page learns what moved and when instead of discovering a field is gone.

Date	Change
2026-08-01	Per-second pricing retired. rate_basis is now per_unit or cpm, and cost_per_second is removed from the rate entry and from the seller-hosted pull contract. Creative length is a key axis of the rate card, so a card prices each length it sells and the platform derives no length's rate from another's. A request carrying rate_basis: "per_second" is refused 422 INVALID_INPUT.