# Changelog

Track documentation updates and confirmed API changes.

API 4.0 · 4.1

## Reading API versions

Each endpoint page displays its API route version, such as **API 4.0** or **API 4.1**, above the title. Use the exact HTTP method and URL shown on that page. A different version number is not a reason to replace the version in an existing URL.

Shared guides list the versions they cover. Webhook receiving and payload pages describe delivery to your server, so they are not tied to a version in a Subiz API route.

## 2026-11-17 — Documentation update

**Documentation only · No API behavior change announced**

- Rewrote the English Conversations & Messages endpoint pages: Send to a conversation, Send to a customer, Get conversation details, Read message history, Invite an agent, and Assign an agent. Pages now include response examples, limits, and next steps.
- Rewrote the English Customers (Users) pages: Create a customer, Get customer details, Update customer details, and Find or create by channel identity. Pages now list the built-in customer attributes and include response examples.
- Added the English User and attribute format page under Customers (Users), covering the User and Attribute objects, value types, multiple values, and built-in attributes.
- Added English Orders pages: Order format, Create an order, List orders, Get order details, and Update an order. They replace the Orders navigation outline.
- Added English Products pages: Product format, Create a product, List products, Get product details, and Update a product. They replace the Products navigation outline.
- Added English Agents pages: Agent format, List agents, and Get agent details.
- Send to a customer now documents identifying the customer by channel identity with top-level `channel`, `channel_source`, and `profile_id`.
- Added Vietnamese versions of every page, including all pages listed above. Use the language menu in the header to switch.

## 2026-11-14 — Documentation update

**Documentation only · No API behavior change announced**

- Added API version labels to individual pages.
- Added English Usage limits and Errors guides with verified payload limits, error response fields, and retry guidance.
- Updated usage-limit guidance for per-token, shared account, and per-agent message allowances, UTC daily resets, and HTTP 429 responses with Retry-After.
- Added this changelog for documentation updates and future confirmed API changes.
- Expanded the English webhook guides with signature verification, delivery handling, and customer event payloads. The Vietnamese webhook translation is awaiting an update.
- Added Orders and Products as navigation outlines awaiting verified articles.

This entry does not claim that any API operation was introduced or deprecated on this date. No API 4.2 operation is documented yet.

## API change announcements

No source-confirmed API release history has been added yet. Future entries will identify the affected API versions and operations, the effective date, whether the change is breaking, and any required migration steps.