---
title: "ChristianPicks API deprecation and Sunset policy"
description: "How ChristianPicks deprecates catalog API endpoints and when Sunset headers appear."
canonical: "https://christianpicks.com/deprecation"
last-updated: "2026-09-12"
---
# Deprecation and Sunset policy

This page is the ChristianPicks API lifecycle policy. It covers how we deprecate endpoints, how we use the HTTP `Deprecation` and `Sunset` headers, and how long you have to migrate.

## Current status

The public catalog API is version **1.0.0**, described by https://christianpicks.com/openapi.json. No public discovery endpoints are deprecated. There is no Sunset date on any catalog route.

Stable surfaces include `GET /api`, `GET /api/v1`, `GET /api/ai/*`, `GET /api/ai/batch`, `POST /api/ai/batch`, `POST /api/ask`, anonymous `/oauth/*` registration, MCP at `/mcp`, and the well-known discovery files.

## What “deprecated” means

An operation marked `deprecated: true` in OpenAPI still works. We will also publish it on this page. When a removal date is known, responses for that operation include:

- `Deprecation` (RFC 9745) with the date we marked the operation obsolete
- `Sunset` (RFC 8594) with the date we plan to remove it
- `Link: <https://christianpicks.com/deprecation>; rel="deprecation"`

We do not send Sunset dates on healthy, current endpoints.

## Notice window

Breaking changes to the public catalog API get at least **12 months** of notice before removal, unless a change is required for security or legal compliance. Additive fields, new endpoints, and new optional headers can ship without a Sunset date.

`GET /api/v1` is an alias of the current catalog API. We will not remove `/api` or `/api/v1` without following this policy.

## How to stay current

1. Read OpenAPI at https://christianpicks.com/openapi.json. Check `info.version` and any `deprecated` flags.
2. Recheck this page. The HTML copy is at https://christianpicks.com/deprecation.
3. Watch `Deprecation` and `Sunset` response headers on the affected routes.
4. Prefer documented fields over undocumented ones.

Questions: [developer resources](https://christianpicks.com/developers) or contact@christianpicks.com.