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-Key header or _idempotency_key field.
  • 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

  1. Update the Laravel implementation and tests.
  2. Regenerate backend/openapi.json.
  3. Update the affected documentation page.
  4. Add a changelog entry.
  5. Run OpenAPI validation, contract tests, docs build and link checks.