> For the complete documentation index, see [llms.txt](https://diffio.ai/llms.txt). This page is also available as HTML at https://diffio.ai/docs/overview/changelog/.

# Changelog and versioning

What changed in the Diffio API and SDKs, newest first, and what the `/v2` API promises.

**Current versions**

1. API `/v2`, Python `diffio` 1.0.0, Node.js `diffio` 1.0.19: Documented
2. API older versions, Python 0.x, Node.js 0.x: Still running, not described here

## Changelog

1. November 15, 2026

   ### SDK releases

   - Node.js diffio 1.0.1 to 1.0.19: version number only, the same code as 1.0.0.
2. November 13, 2026

   ### API v2 docs and SDK 1.0

   - [Python diffio 1.0.0 and Node.js diffio 1.0.0 released: /v2 only, snake_case fields like the wire.](https://diffio.ai/docs/developers/quick-start/)
   - These docs describe /v2 only; older versions keep running.
3. November 12, 2026

   ### Webhooks, one error catalogue

   - [Ten webhook events: generation, separated tracks, export, assistant turn and project.](https://diffio.ai/docs/developers/webhooks/)
   - [Dashboard keys with write access can open the webhook portal.](https://diffio.ai/docs/api-reference/open-webhook-portal/)
   - [One error catalogue: every code with its status and retry rule, also in OpenAPI x-error-codes.](https://diffio.ai/docs/api-reference/errors/)
   - Every status resource carries error with a stable code when it fails.
   - Every answer carries a Server-Timing header.
4. November 11, 2026

   ### The /v2 resource API

   - [Projects, generations and models as resources; model is a body field.](https://diffio.ai/docs/api-reference/create-generation/)
   - [Playback grants with ready media URLs, and project deletion.](https://diffio.ai/docs/api-reference/get-generation-media/)
   - [Separated tracks: saved mixes and exports.](https://diffio.ai/docs/api-reference/create-generation-export/)
   - [Share links.](https://diffio.ai/docs/api-reference/publish-project-share/)
   - [Usage per account and per end user, and the Diffio-End-User header.](https://diffio.ai/docs/api-reference/usage-summary/)
   - [Transcripts, drafts, transcript edits and the edit assistant.](https://diffio.ai/docs/api-reference/get-transcript/)
   - [Account-wide Idempotency-Key with conflict detection.](https://diffio.ai/docs/api-reference/create-project/)

## Versioning

The version is in the path: `https://api.diffio.ai/v2`. Within `/v2`, changes only add.

| Change | Within `/v2` |
| --- | --- |
| New endpoints, optional request fields, response fields, error codes, webhook events | Any time. Ignore fields and codes you do not know. |
| Removing or renaming a field, endpoint, error code or event | Never. Only in a new version path; the old one keeps running. |
| Retiring a model | Kept working. A retired model name runs on the current model of its tier, at the lower price ([Models](https://diffio.ai/docs/overview/models/)). |
| `error.code` values | Stable. Branch on the code, not the message ([Errors](https://diffio.ai/docs/api-reference/errors/)). |

- **Announcements:**: every change is listed on this page with its date; a deprecation is listed here before it takes effect.
- **SDKs:**: semantic versions. 1.x talks to `/v2`; a minor release adds methods, a patch fixes; a new major follows a new API version.
- **Machine-readable:**: the OpenAPI document at `GET https://api.diffio.ai/v2/openapi.json` always matches the running API.

## Support and status

- **Email:** [support@diffio.ai](mailto:support@diffio.ai). Include the `request_id` from the error (also the `X-Request-Id` header).
- **Status page:** Diffio has no public status page. If calls keep failing with `5xx` after the SDK retries, email support with a `request_id`.
