Skip to content
Current versions
For AI agents: every API docs page in one plain-text file is at /docs/llms-full.txt, and the documentation index is at /llms.txt. This page is available as Markdown at https://diffio.ai/docs/overview/changelog.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

Changelog and versioning
What changed in the Diffio API and SDKs, newest first, and what the /v2 API promises.
- API
/v2, Pythondiffio1.0.0, Node.jsdiffio1.0.19: Documented - API older versions, Python 0.x, Node.js 0.x: Still running, not described here
Changelog
SDK releases
- Node.js diffio 1.0.1 to 1.0.19: version number only, the same code as 1.0.0.
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.
- These docs describe /v2 only; older versions keep running.
Webhooks, one error catalogue
- Ten webhook events: generation, separated tracks, export, assistant turn and project.
- Dashboard keys with write access can open the webhook portal.
- One error catalogue: every code with its status and retry rule, also in OpenAPI x-error-codes.
- Every status resource carries error with a stable code when it fails.
- Every answer carries a Server-Timing header.
The /v2 resource API
- Projects, generations and models as resources; model is a body field.
- Playback grants with ready media URLs, and project deletion.
- Separated tracks: saved mixes and exports.
- Share links.
- Usage per account and per end user, and the Diffio-End-User header.
- Transcripts, drafts, transcript edits and the edit assistant.
- Account-wide Idempotency-Key with conflict detection.
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). |
error.code values | Stable. Branch on the code, not the message (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.jsonalways matches the running API.
Support and status
- Email: support@diffio.ai. Include the
request_idfrom the error (also theX-Request-Idheader). - Status page: Diffio has no public status page. If calls keep failing with
5xxafter the SDK retries, email support with arequest_id.