---
title: "Changelog"
description: "Changes to the NimbusMint Partner API and these docs."
canonical: "https://docs.nimbusmint.bot/changelog/"
---
> Index: https://docs.nimbusmint.bot/llms.txt

# Changelog

Every change to the Partner API is listed here, newest first. Breaking changes to v1 are announced to partners before they ship.
Subscribe to the [Atom feed](https://docs.nimbusmint.bot/changelog.xml) to get new entries.

## v1 preview update (2026-10-13)

- `GET /partner/v1/hits`: each `users[]` row now carries the user's identity: `user_id`, `discord_id`,
  `discord_username` and `wallets`. `handle` is unchanged.
- New `GET /partner/v1/mints`: one row per successful mint (`task_id`, user identity, `wallet`, `chain_id`,
  `contract`, `tx_hash`, `quantity`, `completed_at`), oldest first, paged with an opaque `cursor` (`limit` 1–500).

## v1 preview (2026-10-08)

First public draft of the Partner API docs, generated from the v1 OpenAPI spec (preview: not yet live).

- `GET /partner/v1/hits`: successful mints on a contract booked through your app, in a window of up to 31 days
  (currently), with masked per-user rows and gas settings.
- `GET /partner/v1/health`: the calling key's own metadata (`tenant`, `key_id`, `scopes`, `expires_at`), to test
  your setup and watch the expiry date.
- Server-to-server auth: private key (`Authorization: Bearer nmk_live_<id>_<secret>`) with a required IP
  allowlist, one-year expiry, scopes (`read:hits`) and per-key rate limits (default 60 requests a minute, burst 20).
- Errors are JSON `{code, message}`; authentication failures are always `401 invalid_key`.
- Request signing with Ed25519 announced as coming soon.

Changes within v1 are additive only: new optional fields, new routes and new error codes. Ignore fields you do not
know.