# Let's Work API versioning and deprecation policy

The public marketing API is versioned in the URL path: `/wp-json/lw/v1/`.

## Compatibility promise

- **v1** is the current stable version. Additive, backwards-compatible changes may ship without a new version.
- Breaking changes ship as `/wp-json/lw/v2/` (or a later integer). v1 remains reachable at least **180 days** after v2 is declared stable.
- Agents should send `Accept: application/json` (or `application/problem+json` for errors) and read `API-Version`.

## How we signal deprecation

When an operation or version is deprecated we:

1. Set the `Deprecation` header (RFC 9745) to the deprecation instant, and
2. Set the `Sunset` header (RFC 8594) to the UTC date when the resource will be removed, and
3. Update this page and the OpenAPI spec (`deprecated: true` on the operation).

Current v1 operations are **not deprecated**. Responses include `API-Version: 1` so agents can pin behavior.

## Contact

Questions: atendimento@letswork.com.br — https://www.letswork.com.br/contact/