# API Lifecycle and Versioning

The BoxOfChocolates.ai Public Information API is currently version `v1`. Its major version appears in the base path: `https://boxofchocolates.ai/api/v1`.

Additive changes, such as new optional response fields or new read-only endpoints, may be introduced within `v1`. A change that removes or changes an existing field, endpoint, or documented meaning will use a new major-version path.

If an API version is deprecated, BoxOfChocolates.ai will document the replacement in the developer resources and OpenAPI description and return standard `Deprecation`, `Sunset`, and successor `Link` response headers. No deprecation or sunset is currently scheduled for `v1`.

Questions about an integration can be sent to [info@boxofchocolates.ai](mailto:info@boxofchocolates.ai).