Changelog

Every contract-visible change, newest first. Deprecations additionally go to each key's integration contact by email — see the handbook for the policy.

Pre-release. The API below is implemented and under test but not yet generally available to members. Entries describe the v1 surface as it is being built; the GA announcement will appear here.

2026-09-01 — v1 development: exports, durable idempotency, per-key limits

Added POST/GET /v1/charges/{id}/exports — ERP export acknowledgements (the dedup fence). Charge status gains exported, including filter[status]=exported.
Added GET /v1/openapi.json — the generated specification, publicly served in every environment.
Idempotency-Key replay is now durable across service restarts.
Per-key rate-limit raises are now possible (see the handbook).
Preview spec v9: live surfaces are now marked IMPLEMENTED; corrected resource.class to the real domain values (scheduled | application | service | scheduled_addon | event).

2026-09-01 — v1 development: write surfaces

Added cost-center writes: POST /v1/cost-centers, PATCH /v1/cost-centers/{id} (inactivation; If-Match required) and filter[code]. New scope cost-centers:write. Built from member feedback (forum, Aug 2026).
Added group-member administration: POST /v1/groups/{id}/members, DELETE /v1/groups/{id}/members/{user_id}. New scope groups:write. Users are never auto-created. Built from member feedback (forum, Jul 2026).
Added Idempotency-Key requirement on all POST/PATCH requests, with byte-identical replay.

2026-09-01 — v1 development: read surfaces

Added GET /v1/resources and GET /v1/resources/{id} — provider-scoped resource directory.
Added GET /v1/charges, …/{id}, …/{id}/line-items — the primary ERP surface over booking and request charges. (Product-order charges follow in a later increment.)
Added collection conventions everywhere: envelope, cursor pagination (forward-only in v1), filter[field][op] with per-field safelists, multi-key sort, RFC 9457 errors with code + trace_id, ETag/If-None-Match on single reads.

2026-08 — preview v8: first feedback-driven revision

All five member suggestions on the feedback forum addressed: cost-center writes and group-member writes committed to v1; project creation and resource provisioning proposed for v1.1; charge batches (period-close vetting) opened as a design proposal.
Invoice model corrected: an invoice may span many cost centers.
Four provisioning scopes added, kept separate from end-user scopes.

2026-04 — preview v7: contract proposal published

Full proposed surface (98 paths) published for member review at api-preview.openiris.io with the feedback forum attached.