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.
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.
A Binding resource of Programmable Chat represents a push notification subscription for a User within their Service instance. Bindings are unique per service instance, user identity, device, and notification channel (such as APNS, GCM, FCM).
We recommend following the standard URI specification and avoid the following reserved characters ! * ' ( ) ; : @ & = + $ , / ? % # [ ]
for values such as identity and friendly name.
Each Binding resource contains these properties.
sid
type: SID<BS>The unique string that we created to identify the Binding resource.
^BS[0-9a-fA-F]{32}$
34
34
account_sid
type: SID<AC>The SID of the Account that created the Binding resource.
^AC[0-9a-fA-F]{32}$
34
34
service_sid
type: SID<IS>The SID of the Service the Binding resource is associated with.
^IS[0-9a-fA-F]{32}$
34
34
date_created
type: string<date-time>The date and time in GMT when the resource was created specified in ISO 8601 format.
date_updated
type: string<date-time>The date and time in GMT when the resource was last updated specified in ISO 8601 format.
endpoint
type: stringThe unique endpoint identifier for the Binding. The format of this value depends on the binding_type
.
identity
type: stringThe application-defined string that uniquely identifies the resource's User within the Service. See access tokens for more info.
credential_sid
type: SID<CR>The SID of the Credential for the binding. See push notification configuration for more info.
^CR[0-9a-fA-F]{32}$
34
34
binding_type
type: enum<string>The push technology to use for the Binding. Can be: apn
, gcm
, or fcm
. See push notification configuration for more info.
gcm
apn
fcm
GET https://chat.twilio.com/v2/Services/{ServiceSid}/Bindings/{Sid}
ServiceSid
type: SID<IS>The SID of the Service to fetch the Binding resource from.
^IS[0-9a-fA-F]{32}$
34
34
Sid
type: SID<BS>The SID of the Binding resource to fetch.
^BS[0-9a-fA-F]{32}$
34
34
GET https://chat.twilio.com/v2/Services/{ServiceSid}/Bindings
ServiceSid
type: SID<IS>The SID of the Service to read the Binding resources from.
^IS[0-9a-fA-F]{32}$
34
34
BindingType
type: array[string]The push technology used by the Binding resources to read. Can be: apn
, gcm
, or fcm
. See push notification configuration for more info.
gcm
apn
fcm
Identity
type: array[string]The User's identity
value of the resources to read. See access tokens for more details.
PageSize
type: integerHow many resources to return in each list page. The default is 50, and the maximum is 1000.
1
Page
type: integerThe page index. This value is simply for client state.
0
DELETE https://chat.twilio.com/v2/Services/{ServiceSid}/Bindings/{Sid}
ServiceSid
type: SID<IS>The SID of the Service to delete the Binding resource from.
^IS[0-9a-fA-F]{32}$
34
34
Sid
type: SID<BS>The SID of the Binding resource to delete.
^BS[0-9a-fA-F]{32}$
34
34