Skip to contentSkip to navigationSkip to topbar
On this page

Changelog: Twilio Chat REST API


(error)

Danger

Programmable Chat has been deprecated and is no longer supported. Instead, we'll be focusing on the next generation of chat: Twilio Conversations. Find out more about the EOL process here(link takes you to an external page).

If you're starting a new project, please visit the Conversations Docs to begin. If you've already built on Programmable Chat, please visit our Migration Guide to learn about how to switch.


Change Logs

change-logs page anchor

Updates and Changes to the Programmable Chat REST API will be posted by date the change was released on.


October 4, 2017

october-4-2017 page anchor

V2

v2 page anchor
New Features
new-features page anchor
  • Channel subresources are now accessible directly by channel UniqueName for all operations (GET, POST, DELETE)
  • Member now accessible through user Identity for all operations (GET, POST, DELETE)
  • Added Service instance webhook retry configuration options
  • Added media message capability for sending new Messages referencing Media resources
  • Allow posting empty Message body from API
  • Minor bug fix for a rare race condition when adding channel members
  • Added new mutable parameters to Channels (Create and Update): DateCreated, DateUpdated, CreatedBy
  • Added new mutable parameters to Members (Create and Update): DateCreated, DateUpdated, LastConsumedMessageIndex, LastConsumptionTimestamp
  • Added new mutable API parameters to Messages (Create and Update): DateCreated, DateUpdated, From, LastUpdatedBy
  • Exposed new resource field for Messages: LastUpdatedBy
  • Attributes are now returned for LIST GETS in the /v2 for Channels, Messages and Users
  • If Attributes are not set, "{}" will be returned
  • /v2 of the Chat REST API Released.
  • The maximum page size for all LIST GETS in /v2 is now 100 (down from 1000). Note that in /v1 this is still 1000.
New Features and Capabilities
new-features-and-capabilities page anchor
  • A new endpoint, Channels, has been added as a sub-resoure of the Users resource. This will return all the joined Channels for the specified User. The location for this endpoint is: /v2/Services/\{Service sid\}/Users/\{User sid\}/Channels
  • A new request parameter, Order, has been added to the Messages LIST GET endpoint. This parameter allows the latest Messages list in a Channel to be retrieved - order descending vs the default ascending. The valid options are asc and desc
  • A number of new configuration options have been added to the Services endpoint. These include options to change Service instance Limits, enable iOS Badge counts for new message pushes and more.
  • /v1 of the Chat REST API has been deprecated. Please switch to /v2 as soon as possible.
  • Webhooks V1 configuration field webhooks in Service endpoint has been removed.