> ## Documentation Index
> Fetch the complete documentation index at: https://help.nops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Versioning & changelog

> How the nOps Public API is versioned and what has changed

# Versioning

The nOps Public API is versioned in the URL path. The current version is `v1`
(for example, `https://api.nops.io/v1/reports`).

We consider the following changes **backward compatible**, and may ship them
within `v1` without notice:

* Adding new endpoints, resources, or optional request parameters
* Adding new fields to existing responses
* Adding new values to enums or new error `code` strings
* Changing the ordering of results (unless documented otherwise)

Breaking changes — removing fields, renaming fields, changing types, or altering
authentication — will be introduced under a new version path.

<Tip>
  Write integrations defensively: ignore unknown response fields rather than
  failing on them.
</Tip>

## Changelog

### 2026-07 — Standard list envelope & cursor pagination

* All list endpoints now return a consistent `{ data, pagination }` envelope.
  `data` is an array of resources and `pagination` contains `limit`,
  `has_more`, and `next_cursor`. See [Pagination](/developers/pagination).
* List endpoints accept `limit` (1–200, default 50) and `cursor` query
  parameters. The previous `page`/`pageSize` parameters are no longer used.
* Endpoint-specific extras (for example, `scope_counts` on reports and
  `schedules_by_source` on scheduled notifications) moved into a `meta` object.

### Earlier

* Added Cost Allocation endpoints (showbacks, rules, previews, and summaries).
* Interactive API Reference published.

## Reserved

* `Commitments` endpoints are reserved and return `501` until they are
  generally available.