# Changelog

> Dated changes to the BloomText API, MCP server, CLI, and these docs, including new endpoints, fields, and behavior changes.

Source: https://www.bloomtext.com/developers/api/changelog/

Changes to the BloomText API, MCP server, and CLI. The API is versioned in the URL (`/v1`). Additive changes, like new endpoints, fields, or event types, ship within `v1`, so build clients that ignore fields they don't recognize. Breaking changes would ship as a new version, announced here first.

## September 22, 2026

### BloomText API v1

The first public version of the BloomText API.

- **REST API** at `https://api.bloomtext.com/v1`, with organization-scoped [API keys](https://www.bloomtext.com/developers/api/authentication/) and [scopes](https://www.bloomtext.com/developers/api/authentication/#scopes).
- **Resources:** [organization](https://www.bloomtext.com/developers/api/reference/organization-object/), [users](https://www.bloomtext.com/developers/api/reference/user-object/), [conversations](https://www.bloomtext.com/developers/api/reference/conversation-object/), [messages and replies](https://www.bloomtext.com/developers/api/reference/message-object/), [reactions](https://www.bloomtext.com/developers/api/reference/reaction-object/), [participants](https://www.bloomtext.com/developers/api/reference/participant-object/), [broadcasts](https://www.bloomtext.com/developers/api/reference/broadcast-object/), and [exports](https://www.bloomtext.com/developers/api/reference/export-object/).
- **[Webhooks](https://www.bloomtext.com/developers/api/webhooks/)** for messages, reactions, participants, and exports, signed with HMAC-SHA256.
- **[Idempotency keys](https://www.bloomtext.com/developers/api/idempotency/)** on every write, [cursor pagination](https://www.bloomtext.com/developers/api/pagination/), and [problem details errors](https://www.bloomtext.com/developers/api/errors/).
- **[MCP server](https://www.bloomtext.com/developers/api/mcp/)** at `https://mcp.bloomtext.com/mcp`, the [`bloomtext` CLI](https://www.bloomtext.com/developers/api/cli/), and an [agent skill](https://www.bloomtext.com/developers/api/mcp/#agent-skill).
- **[OpenAPI 3.1 spec](https://www.bloomtext.com/developers/api/openapi/bloomtext-api.yaml)** and [docs for AI agents](https://www.bloomtext.com/developers/api/llms/).