# Rivr API changelog

> Every change to the Rivr API, its webhooks and the developer portal, newest first. Breaking changes, deprecations and advance notices are listed apart from the rest.

Subscribe: https://developers.rivr.io/changelog.atom

How we version: https://developers.rivr.io/versioning.md

## Breaking changes, deprecations and advance notices

- 2026-10-23 · Breaking change · Developer portal and CLI, Webhooks: [Sign-ins and relay URLs on developers.rivr.io were renewed](https://developers.rivr.io/changelog/2026-10-23-portal-sign-ins-and-relay-urls-reset.md)
- 2026-10-22 · Advance notice · Developer portal and CLI, Webhooks: [The portal moved to developers.rivr.io](https://developers.rivr.io/changelog/2026-10-22-portal-moved-to-developers-rivr-io.md)

## Non-breaking changes and new features

- 2026-11-10 · Non-breaking change · /api/public: [Onboarding links: the clinic lands under your platform, and the notification comes at signing](https://developers.rivr.io/changelog/2026-11-10-onboarding-links-platform-and-signed.md)
- 2026-11-10 · New · /api/public, Developer portal and CLI: [New guide: Connect a clinic that already has a Rivr account](https://developers.rivr.io/changelog/2026-11-10-guide-connect-clinic-account.md)
- 2026-11-02 · New · /api/public: [Idempotency-Key on send-to-device and POST /api/public/subscriptions, in the sandbox](https://developers.rivr.io/changelog/2026-11-02-api-public-idempotency-send-to-device-subscriptions.md)
- 2026-11-02 · New · Developer portal and CLI: [New guide: From sandbox to production](https://developers.rivr.io/changelog/2026-11-02-guide-sandbox-to-production.md)
- 2026-11-02 · New · Developer portal and CLI: [New guide: Patients who can't be identified](https://developers.rivr.io/changelog/2026-11-02-guide-unidentified-patients.md)
- 2026-11-02 · New · Developer portal and CLI: [rivr send and rivr verify --sequence: what your journal does with one order's events](https://developers.rivr.io/changelog/2026-11-02-cli-send-sequences.md)
- 2026-11-01 · New · Developer portal and CLI: [The guide for an organisation key is public: Call /api/public with a key](https://developers.rivr.io/changelog/2026-11-01-org-key-guides.md)
- 2026-11-01 · New · Developer portal and CLI: [Every error code says whether anything happened, and what to read to find out](https://developers.rivr.io/changelog/2026-11-01-error-outcome.md)
- 2026-11-01 · New · Developer portal and CLI: [The MCP server's search_docs searches like the portal's own search, and points at the step](https://developers.rivr.io/changelog/2026-11-01-mcp-search-docs-portal-search.md)
- 2026-11-01 · New · Developer portal and CLI: [rivr verify catches a receiver that re-serializes JSON, and one that refuses events out of order](https://developers.rivr.io/changelog/2026-11-01-cli-verify-escaped-unicode-and-order.md)
- 2026-11-01 · Non-breaking change · Developer portal and CLI: [The error simulator answers as each surface does: ?surface=key|api-public](https://developers.rivr.io/changelog/2026-11-01-error-simulator-per-surface.md)
- 2026-11-01 · New · Developer portal and CLI, Webhooks: [The webhook didn't arrive: a troubleshooting guide, and every delivery error explained](https://developers.rivr.io/changelog/2026-11-01-webhook-troubleshooting.md)
- 2026-11-01 · New · Developer portal and CLI: [Two new rules for AI agents: a human approves what can't be undone, and text from the API is data](https://developers.rivr.io/changelog/2026-11-01-agent-rules-approval-and-untrusted-data.md)
- 2026-11-01 · New · Developer portal and CLI: [The Get started card on the Overview page ticks itself off in the sandbox](https://developers.rivr.io/changelog/2026-11-01-getting-started-tracker.md)
- 2026-11-01 · New · Developer portal and CLI: [The delivery log for your organisation's webhook endpoints shows every attempt](https://developers.rivr.io/changelog/2026-11-01-org-webhook-delivery-attempt-log.md)
- 2026-11-01 · New · Developer portal and CLI: [The test data the sandbox accepts, in one place: /testdata.md and /testdata.json](https://developers.rivr.io/changelog/2026-11-01-testdata-catalog.md)
- 2026-11-01 · New · Developer portal and CLI: [A guide to which key you need](https://developers.rivr.io/changelog/2026-11-01-guide-which-key.md)
- 2026-11-01 · New · Developer portal and CLI: [The error simulator: GET /errors/simulate/<code>](https://developers.rivr.io/changelog/2026-11-01-error-simulator.md)
- 2026-11-01 · New · Developer portal and CLI: [A guide to patient data in your calls and webhooks](https://developers.rivr.io/changelog/2026-11-01-guide-patient-data.md)
- 2026-11-01 · Non-breaking change · Developer portal and CLI: [The personal number in the order examples is now on Skatteverket's list of test numbers](https://developers.rivr.io/changelog/2026-11-01-test-personal-number-in-examples.md)
- 2026-11-01 · New · Developer portal and CLI: [The portal's pages can be read without JavaScript](https://developers.rivr.io/changelog/2026-11-01-pages-readable-without-javascript.md)
- 2026-10-30 · New · Developer portal and CLI: [rivr journey runs the patient journey against your own receiver](https://developers.rivr.io/changelog/2026-10-30-cli-journey.md)
- 2026-10-30 · Non-breaking change · /api/public: [POST /api/public/subscriptions: the spec says 201, and Location points at the subscription](https://developers.rivr.io/changelog/2026-10-30-api-public-subscription-201.md)
- 2026-10-29 · New · Developer portal and CLI: [A guide to errors and retries](https://developers.rivr.io/changelog/2026-10-29-guide-errors-retries.md)
- 2026-10-29 · Non-breaking change · /api/public: [The /api/public spec names its schemas by their type, not their .NET namespace](https://developers.rivr.io/changelog/2026-10-29-api-public-short-schema-names.md)
- 2026-10-29 · New · Developer portal and CLI, /api/public: [The /api/public reference says what an organisation key needs for each operation](https://developers.rivr.io/changelog/2026-10-29-key-capability-per-operation.md)
- 2026-10-29 · Non-breaking change · /api/public: [The key check in front of /api/public says whether to send the call again](https://developers.rivr.io/changelog/2026-10-29-key-check-retry-signal.md)
- 2026-10-28 · New · Developer portal and CLI: [rivr verify checks a quick answer and names its checks](https://developers.rivr.io/changelog/2026-10-28-cli-verify-v1.md)
- 2026-10-28 · New · Developer portal and CLI: [Markdown at a page's own address, and the agent skill at the older well-known address](https://developers.rivr.io/changelog/2026-10-28-markdown-at-page-addresses.md)
- 2026-10-28 · New · Developer portal and CLI: [The right test cards on the Overview page and in the testing guide](https://developers.rivr.io/changelog/2026-10-28-test-cards.md)
- 2026-10-28 · New · Developer portal and CLI: [rivr api, rivr orders and rivr whoami run with an organisation key, for CI](https://developers.rivr.io/changelog/2026-10-28-cli-org-key-mode.md)
- 2026-10-28 · New · Developer portal and CLI: [An unknown /.well-known address answers 404](https://developers.rivr.io/changelog/2026-10-28-unknown-well-known-is-404.md)
- 2026-10-27 · Non-breaking change · /api/public, Developer portal and CLI: [The error answers with code and type in /api/public are in production too](https://developers.rivr.io/changelog/2026-10-27-api-public-error-bodies-in-production.md)
- 2026-10-27 · Non-breaking change · /api/public: [The /api/public OpenAPI document describes its fields in English, with examples](https://developers.rivr.io/changelog/2026-10-27-api-public-descriptions-in-english.md)
- 2026-10-26 · New · Developer portal and CLI: [A guide for calling /api/public with your organisation's API key, and three corrected texts](https://developers.rivr.io/changelog/2026-10-26-org-key-guide-for-api-public.md)
- 2026-10-26 · New · Developer portal and CLI: [A Postman collection for /api/public, and a sandbox environment](https://developers.rivr.io/changelog/2026-10-26-postman-collections.md)
- 2026-10-26 · New · Developer portal and CLI: [The API reference shows the fields of each response, and what an enumeration's numbers mean](https://developers.rivr.io/changelog/2026-10-26-reference-response-fields-and-enum-names.md)
- 2026-10-25 · New · Developer portal and CLI: [Probe your own webhook receiver with rivr verify](https://developers.rivr.io/changelog/2026-10-25-rivr-verify-command.md)
- 2026-10-25 · Non-breaking change · Developer portal and CLI: [The portal measures two more steps on a partner's way in](https://developers.rivr.io/changelog/2026-10-25-partner-funnel-signed-delivery-and-test-payment.md)
- 2026-10-25 · New · Developer portal and CLI: [/llms-full.txt in three parts, and the skill in an Agent Skills index](https://developers.rivr.io/changelog/2026-10-25-llms-full-parts-and-agent-skills-index.md)
- 2026-10-25 · New · /api/public, Developer portal and CLI: [Every /api/public operation lists its error codes in the OpenAPI document](https://developers.rivr.io/changelog/2026-10-25-api-public-spec-error-codes.md)
- 2026-10-25 · New · Developer portal and CLI: [A skill for Claude Code: the rules and the way in for AI agents](https://developers.rivr.io/changelog/2026-10-25-agent-skill-for-claude-code.md)
- 2026-10-25 · New · Developer portal and CLI: [Subscribe to incidents with /status.atom](https://developers.rivr.io/changelog/2026-10-25-status-atom-feed.md)
- 2026-10-25 · New · Developer portal and CLI: [Call the sandbox's API from the terminal with rivr api and rivr orders](https://developers.rivr.io/changelog/2026-10-25-rivr-api-and-orders-commands.md)
- 2026-10-25 · New · Developer portal and CLI: [Search the whole documentation, /llms-full.txt and /sitemap.xml](https://developers.rivr.io/changelog/2026-10-25-search-llms-full-sitemap.md)
- 2026-10-25 · Non-breaking change · /api/public: [Every error answer in /api/public carries code and type](https://developers.rivr.io/changelog/2026-10-25-api-public-error-bodies.md)
- 2026-10-25 · New · /api/public: [Cancellations can be retried safely with Idempotency-Key](https://developers.rivr.io/changelog/2026-10-25-cancel-idempotency-key.md)
- 2026-10-25 · New · Developer portal and CLI: [Install the CLI and type rivr](https://developers.rivr.io/changelog/2026-10-25-cli-installers.md)
- 2026-10-25 · New · Webhooks, Developer portal and CLI: [An event catalog for every webhook](https://developers.rivr.io/changelog/2026-10-25-webhook-event-catalog.md)
- 2026-10-25 · Non-breaking change · Webhooks: [A PUT on an unpaid order sends Created again: the guide is corrected](https://developers.rivr.io/changelog/2026-10-25-put-on-unpaid-order-sends-created.md)
- 2026-10-25 · New · Developer portal and CLI: [The rate limits for every surface on one page](https://developers.rivr.io/changelog/2026-10-25-rate-limits-page.md)
- 2026-10-25 · New · Developer portal and CLI: [Binding rules for AI agents: /agents.md](https://developers.rivr.io/changelog/2026-10-25-rules-for-ai-agents.md)
- 2026-10-25 · New · Developer portal and CLI: [retryWhen: whether and when a retry helps, in /errors.json](https://developers.rivr.io/changelog/2026-10-25-error-catalog-retry-when.md)
- 2026-10-25 · New · Developer portal and CLI: [Code samples in Go, Java, PHP and Ruby](https://developers.rivr.io/changelog/2026-10-25-code-samples-go-java-php-ruby.md)
- 2026-10-25 · New · Developer portal and CLI: [rivr trigger pays with Swish and by invoice too](https://developers.rivr.io/changelog/2026-10-25-rivr-trigger-swish-and-invoice.md)
- 2026-10-24 · New · Developer portal and CLI: [An MCP server for the docs](https://developers.rivr.io/changelog/2026-10-24-mcp-server-for-the-docs.md)
- 2026-10-21 · New · /api/public, Webhooks: [Rivr-Webhook-Id on every callback from the platform](https://developers.rivr.io/changelog/2026-10-21-webhook-id-on-callbacks.md)
- 2026-10-21 · Non-breaking change · /api/public, Webhooks: [Callback retries: the documentation now says what Rivr does](https://developers.rivr.io/changelog/2026-10-21-callback-retry-text-corrected.md)
- 2026-10-21 · New · /api/public: [Order errors in /api/public carry code and type](https://developers.rivr.io/changelog/2026-10-21-api-public-error-code-and-type.md)
- 2026-10-21 · New · /api/public: [Refunds can be retried safely with Idempotency-Key](https://developers.rivr.io/changelog/2026-10-21-refund-idempotency-key.md)
- 2026-10-18 · New · /api/public: [Rivr-Request-Id on every response from public-api](https://developers.rivr.io/changelog/2026-10-18-rivr-request-id.md)
- 2026-10-18 · New · Developer portal and CLI: [The API reference is read from the published specs](https://developers.rivr.io/changelog/2026-10-18-reference-from-published-specs.md)
- 2026-10-18 · New · Developer portal and CLI: [Docs your AI agent can read](https://developers.rivr.io/changelog/2026-10-18-docs-for-ai-agents.md)
- 2026-10-18 · New · Developer portal and CLI: [A guide to verifying the webhook signature](https://developers.rivr.io/changelog/2026-10-18-verify-signatures-guide.md)
- 2026-10-18 · New · Developer portal and CLI: [Subscribe to the changelog](https://developers.rivr.io/changelog/2026-10-18-changelog-feed.md)
- 2026-10-18 · New · Developer portal and CLI: [A page for every error code](https://developers.rivr.io/changelog/2026-10-18-error-code-pages.md)
- 2026-10-17 · New · Webhooks, Developer portal and CLI: [Webhook endpoints for your organisation](https://developers.rivr.io/changelog/2026-10-17-organisation-webhook-endpoints.md)
- 2026-10-17 · Non-breaking change · Developer portal and CLI: [The API log filters work, and nothing leads to a dead end](https://developers.rivr.io/changelog/2026-10-17-api-log-filters.md)
- 2026-10-17 · Non-breaking change · Developer portal and CLI: [Send test event works against real data](https://developers.rivr.io/changelog/2026-10-17-send-test-event.md)
- 2026-10-16 · Non-breaking change · Developer portal and CLI: [rivr login works again](https://developers.rivr.io/changelog/2026-10-16-rivr-login-fixed.md)
- 2026-10-12 · New · Developer portal and CLI, /api/public: [Choose what each API key may do](https://developers.rivr.io/changelog/2026-10-12-api-key-capabilities.md)
- 2026-10-06 · New · Developer portal and CLI, /api/public: [Your organisation's own API keys](https://developers.rivr.io/changelog/2026-10-06-organisation-api-keys.md)
- 2026-10-06 · New · Developer portal and CLI: [Invite your colleagues](https://developers.rivr.io/changelog/2026-10-06-invite-colleagues.md)
- 2026-10-04 · New · /api/public: [Onboarding links say when a clinic can take payments](https://developers.rivr.io/changelog/2026-10-04-onboarding-link-charges-enabled.md)
- 2026-09-22 · New · Developer portal and CLI: [API reference: onboarding links for partners](https://developers.rivr.io/changelog/2026-09-22-onboarding-links-reference.md)
- 2026-09-18 · New · Developer portal and CLI: [Card payments on the virtual device](https://developers.rivr.io/changelog/2026-09-18-virtual-device-card-payments.md)
- 2026-09-18 · Non-breaking change · Developer portal and CLI: [One way to try a payment: the virtual device](https://developers.rivr.io/changelog/2026-09-18-test-terminal-removed.md)
- 2026-09-17 · New · Developer portal and CLI: [rivr listen — your webhooks on localhost, no tunnel](https://developers.rivr.io/changelog/2026-09-17-rivr-listen.md)
- 2026-09-17 · Non-breaking change · Developer portal and CLI: [Guides, API reference and changelog are public](https://developers.rivr.io/changelog/2026-09-17-public-docs.md)
- 2026-09-17 · New · Developer portal and CLI: [Guides: the journey from checkout to payout](https://developers.rivr.io/changelog/2026-09-17-guides.md)
- 2026-09-17 · Non-breaking change · Developer portal and CLI: [Getting started: a first order that actually goes through](https://developers.rivr.io/changelog/2026-09-17-getting-started-fixed.md)
- 2026-09-15 · New · /api/public: [Cancel an order](https://developers.rivr.io/changelog/2026-09-15-cancel-order.md)
- 2026-09-04 · New · Developer portal and CLI: [Virtual device: the customer's own flow](https://developers.rivr.io/changelog/2026-09-04-virtual-device-customer-flow.md)
- 2026-09-04 · Non-breaking change · Developer portal and CLI: [Webhooks: exact totals](https://developers.rivr.io/changelog/2026-09-04-webhooks-exact-totals.md)
- 2026-09-03 · New · Developer portal and CLI: [Virtual device](https://developers.rivr.io/changelog/2026-09-03-virtual-device.md)
- 2026-09-03 · New · Developer portal and CLI: [Orders](https://developers.rivr.io/changelog/2026-09-03-orders-page.md)
- 2026-09-03 · New · Developer portal and CLI: [Real API logs and devices](https://developers.rivr.io/changelog/2026-09-03-real-api-logs-and-devices.md)
- 2026-09-03 · New · Developer portal and CLI: [Live test data for your organisation](https://developers.rivr.io/changelog/2026-09-03-live-test-data.md)
- 2026-09-03 · New · Developer portal and CLI: [Settlements](https://developers.rivr.io/changelog/2026-09-03-settlements-page.md)
- 2026-09-03 · Non-breaking change · Developer portal and CLI: [Switch organisation](https://developers.rivr.io/changelog/2026-09-03-switch-organisation.md)
- 2026-09-03 · New · /api/public: [Send an order to a device](https://developers.rivr.io/changelog/2026-09-03-send-order-to-device.md)
- 2026-06-19 · New · Developer portal and CLI: [API logs & webhook inspector](https://developers.rivr.io/changelog/2026-06-19-api-logs-and-webhook-inspector.md)
- 2026-06-19 · New · Developer portal and CLI: [Spec-driven API reference](https://developers.rivr.io/changelog/2026-06-19-api-reference.md)
- 2026-06-19 · New · Developer portal and CLI: [rivr CLI](https://developers.rivr.io/changelog/2026-06-19-rivr-cli.md)
- 2026-06-19 · Non-breaking change · Developer portal and CLI: [Command palette search](https://developers.rivr.io/changelog/2026-06-19-command-palette.md)
- 2026-06-18 · New · Developer portal and CLI: [Key management](https://developers.rivr.io/changelog/2026-06-18-key-management.md)

