# Wavicle Public REST API Version and Deprecation Policy

Last updated: 2026-08-26

## Current stable version

- Stable base path: https://www.wavicle.tech/api/v1
- Contract version: 1.0.0
- OpenAPI document: https://www.wavicle.tech/openapi.json
- Current status: no v1 route, field, or parameter is deprecated.

## Compatibility within v1

Wavicle may add new resource routes, optional query parameters, documentation, and non-breaking error detail fields within v1. Existing documented fields keep their types and meanings. Removing a field, changing its type or meaning, or making an optional input required is a breaking change and requires a new major base path such as /api/v2.

## Deprecation and retirement

Before a stable operation is retired, Wavicle will mark it deprecated in OpenAPI and publish a notice here with its replacement and earliest retirement date. A deprecated response will carry a Deprecation header and a Link with rel="deprecation". Once a retirement date is scheduled, it will also carry a Sunset header. Deprecated behavior remains available through the published sunset date.

Because nothing in v1 is currently deprecated, v1 responses do not emit Deprecation or Sunset headers today.

## Operating boundary

This API is public and read-only. It does not accept inquiries, issue quotes, book calls, modify data, authenticate clients, or provide a sandbox. Contact and scheduling remain explicit human actions.