Changelog & versioning

How the Agent API evolves, and what changed when.

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 codes 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 is the source of truth; the reference page and the TypeScript SDK are generated from it.

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.

@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).