API changelog
Public API versions, additive changes and breaking-change policy.
1.0.0 — Initial public contract
- Added primary endpoint
POST /v1/forms/{public_id}/submissions. - Kept
POST /f/{public_id}as a short alias with the same implementation and response contract. - Added idempotency by
Idempotency-Keyheader or_idempotency_keyfield. - Added OpenAPI 3.1 specification at
https://api.postvia.dev/openapi.json. - Documented JSON, URL-encoded and text-only multipart request types.
- Documented stable error codes, rate limits, Turnstile behaviour and retention.
- Added documentation at
https://postvia.dev/docs.
Breaking-change policy
The /v1 contract is stable. Additive changes are released in place. Breaking changes require a new path version, a migration guide and an entry in this changelog before rollout.
How changes are made
- Update the Laravel implementation and tests.
- Regenerate
backend/openapi.json. - Update the affected documentation page.
- Add a changelog entry.
- Run OpenAPI validation, contract tests, docs build and link checks.