# API changelog

Envelope `meta.schema` is currently `"v1"`. Breaking changes require a new schema version and a deprecation window.

## 2026-11

- **Caller self-serve:** `GET /v1/me/billing`, `GET /v1/me/explorer`, webhook list/stats/deliveries/replay under `/v1/me/webhooks/*`
- **Public status:** `GET /v1/public/status` (sanitized cell health rollup)
- **Test ring:** `sb_test_*` keys route to connector sandbox regions or `SB_SIMULATOR_URL`; Axis billing skipped
- **Errors:** `error.retry_after_ms` + HTTP `Retry-After` on 429 / budget / capacity responses
- **Alerts:** `ALERT_NOTIFY_URLS` accepts comma-separated destinations (Slack incoming, PagerDuty, email relay, …)

## Policy

- Additive OpenAPI fields and new optional headers are non-breaking.
- Removing or renaming error codes / paths requires at least 30 days notice on this page and in release notes.
- Connector `version` integers change when ops or egress contracts change; cells load the LKG snapshot — callers should not hard-code connector version ints.