> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.getdial.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getdial.ai/_mcp/server.

# November 12, 2026

## Added

### A published versioning and deprecation policy

The REST API now has a written [versioning and deprecation policy](/documentation/reference/versioning): breaking changes ship under a new path version, and anything deprecated in `/v1` keeps working for at least 6 months, announced with `Deprecation` and `Sunset` response headers.

### `Location` header on asynchronous provisioning

When `POST /v1/numbers` answers `202 Accepted` (an iMessage number still provisioning), the response now carries `Location: https://api.getdial.ai/v1/numbers/{id}`, the URL to poll for the number's status.