A Binding resource in Twilio Conversations 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).
Each Binding resource has the following properties:
sid
type: SID<BS>A 34 character string that uniquely identifies this resource.
^BS[0-9a-fA-F]{32}$
34
34
account_sid
type: SID<AC>The unique ID of the Account responsible for this binding.
^AC[0-9a-fA-F]{32}$
34
34
chat_service_sid
type: SID<IS>The SID of the Conversation Service the Binding resource is associated with.
^IS[0-9a-fA-F]{32}$
34
34
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
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 Conversation User within the Conversation Service. See access tokens for more info.
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.
apn
gcm
fcm
GET https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Bindings/{Sid}
ChatServiceSid
type: SID<IS>The SID of the Conversation Service the Binding resource is associated with.
^IS[0-9a-fA-F]{32}$
34
34
Sid
type: SID<BS>A 34 character string that uniquely identifies this resource.
^BS[0-9a-fA-F]{32}$
34
34
GET https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Bindings
ChatServiceSid
type: SID<IS>The SID of the Conversation Service the Binding resource is associated with.
^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.
apn
gcm
fcm
Identity
type: array[string]The identity of a Conversation User this binding belongs to. 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://conversations.twilio.com/v1/Services/{ChatServiceSid}/Bindings/{Sid}
ChatServiceSid
type: SID<IS>The SID of the Conversation 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