API reference readability improvements
Released: September 10, 2026
Clearer operation pages Changed
Section titled “Clearer operation pages ”Every Public API operation now includes a purpose-focused description. Path and query parameters show realistic examples and explain account scope, timestamp boundaries, filter behavior, and public resource IDs.
Cursor-paginated endpoints now document the default page size of 25, the
maximum of 100, and how to pass next_cursor into the next request. Every
POST operation also displays the optional Idempotency-Key header and its
24-hour replay behavior.
More useful examples Fixed
Section titled “More useful examples ”The messages list reference now shows a complete response envelope instead of a partial generated object. Error responses use examples appropriate to their HTTP status, so authentication failures no longer look like validation errors.
Reference URLs and API behavior are unchanged.
View List messages