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.
Write integrations defensively: ignore unknown response fields rather than
failing on them.
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.
- 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.
