# Changelog & versioning

> How the Agent API evolves, and what changed when.
>
> Markdown mirror of https://nmbr.ai/developers/docs/changelog/ — part of the nmbr Agent API docs (https://nmbr.ai/developers/docs/). Spec: https://nmbr.ai/developers/openapi.yaml · Site index: https://nmbr.ai/llms.txt

## Versioning policy

- The API lives at `/api/agent/v1`. Within `v1`, changes are **additive**: new endpoints, new optional fields, new event types. Fields and event types are never renamed or removed; error `code`s are stable.
- Breaking changes would ship as `/api/agent/v2` alongside `v1`, with a migration guide and a long overlap.
- The spec at [`/developers/openapi.yaml`](/developers/openapi.yaml) is the source of truth; the reference page and the TypeScript SDK are generated from it.

## 2026-08-30 — v1 launch

- Agent accounts (`800-xxx-xxx`), tokens, self-serve creation in the app.
- Messaging: `POST /messages` (all message types), conversations, history, read receipts, typing, reactions, profile.
- Events: `message.received`, `contact.added`; long-poll `GET /updates` with cursor; signed webhooks with retries and rotation.
- Human-in-the-loop approvals: `POST /actions`, native cards in the apps, `action.approved` / `action.rejected` / `action.expired`, fail-closed expiry.
- SDK `@nmbrai/sdk` 0.1.0 (Node ≥ 18, zero dependencies).
- Docs: this site, markdown mirrors, `openapi.yaml`, `llms.txt`.

## 2026-08-30 — plugins, beta

- `@nmbrai/openclaw` 0.1.0-beta.1 (OpenClaw channel plugin), Hermes Agent adapter 0.1.0-beta.1 (`/developers/hermes/`), `@nmbrai/claude-code` 0.1.0-beta.1 (Claude Code channel + generic MCP server). Beta: please report issues.

Coming next: native approval cards inside OpenClaw and Hermes, media in and out, more surfaces (email, feed, tasks, post-call intelligence).