Base URLs and versioning

Production hosts, local development and the versioning policy.
EnvironmentBase URL
Production APIhttps://api.postvia.dev
Local developmenthttp://localhost:8010
Documentationhttps://postvia.dev/docs
Administrationhttps://app.postvia.dev

Versioning

The primary public endpoint is versioned in the path:

/v1/forms/{public_id}/submissions

The /v1 contract is stable. Additive changes such as new optional fields, new examples or new error descriptions are non-breaking. Breaking changes require a new version and a migration note in the changelog.

The short endpoint /f/{public_id} is an alias, not a separate version. It follows the same contract.

OpenAPI

The formal contract is available at:

https://api.postvia.dev/openapi.json

The specification is OpenAPI 3.1 and is generated from the Laravel implementation. Documentation examples are generated from the same source.