# Prescient AI Public API Versioning and Deprecation Policy

## Stable version

The current stable REST API is version 1 and uses the https://prescientai.com/api/v1 path. Every response includes an X-API-Version header with the active date-based build version. The OpenAPI document at https://prescientai.com/openapi.json is the authoritative operation and schema contract.

## Compatible changes

Prescient AI may add optional request parameters, response properties, enum values, endpoints, tools, or documentation within v1. Clients must ignore response properties they do not recognize. Existing required inputs and documented response meanings remain compatible within the major version.

## Breaking changes

Breaking REST changes are released under a new major path such as /api/v2. The existing stable major version remains available throughout the published migration window.

## Deprecation notice

Prescient AI provides at least 180 days of notice before removing a stable operation or major version. The developer portal and OpenAPI description publish the migration guidance. Affected HTTP responses carry a Deprecation header, a Sunset header with the planned removal time, and a Link header pointing to the successor operation or migration policy during the notice period.

No v1 operation is currently deprecated and no sunset date is currently scheduled.

## Support

For versioning questions or migration support, use https://prescientai.com/contact and include the operationId and X-API-Version value from the relevant response.