# JobFinder Public API Version and Deprecation Policy

Last updated: 2026-08-27

## Current stable version

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

## Compatibility within v1

JobFinder may add resource routes, optional inputs, documentation, and non-breaking error detail fields within v1. Removing a documented field, changing its type or meaning, or making an optional input required is a breaking change and requires a new major path such as /api/v2.

## Deprecation and retirement

Before a stable operation is retired, JobFinder will mark it deprecated in OpenAPI and publish a notice here with its replacement and earliest retirement date. Deprecated responses will carry a Deprecation header and a Link with rel="deprecation". Once retirement is scheduled, they will also carry a Sunset header. Nothing in v1 is deprecated today, so current responses do not emit those headers.

## Operating boundary

The API is public and read-only. It does not authenticate clients, accept applications, connect inboxes, send outreach, expose account data, or provide a sandbox. Those product actions require a signed-in user and explicit review or approval.