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.
The User Binding resource provides access to Binding resources that is scoped to a single User.
Each User Binding resource contains these properties.
sid
type: SID<BS>The unique string that we created to identify the User Binding resource.
^BS[0-9a-fA-F]{32}$
34
34
account_sid
type: SID<AC>The SID of the Account that created the User Binding resource.
^AC[0-9a-fA-F]{32}$
34
34
service_sid
type: SID<IS>The SID of the Service the User 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 User Binding. The format of the 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.
user_sid
type: SID<US>The SID of the User with the User Binding resource. See push notification configuration for more info.
^US[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
binding_type
type: enum<string>The push technology to use for the User 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}/Users/{UserSid}/Bindings/{Sid}
The {UserSid}
value can be either the sid
or the identity
of the User resource to fetch the User Binding resource from.
ServiceSid
type: SID<IS>The SID of the Service to fetch the User Binding resource from.
^IS[0-9a-fA-F]{32}$
34
34
UserSid
type: stringThe SID of the User with the User Binding resource to fetch. See push notification configuration for more info.
Sid
type: SID<BS>The SID of the User Binding resource to fetch.
^BS[0-9a-fA-F]{32}$
34
34
GET https://chat.twilio.com/v2/Services/{ServiceSid}/Users/{UserSid}/Bindings
The {UserSid}
value can be either the sid
or the identity
of the User resource to read User Binding resources from.
ServiceSid
type: SID<IS>The SID of the Service to read the User Binding resources from.
^IS[0-9a-fA-F]{32}$
34
34
UserSid
type: stringThe SID of the User with the User Binding resources to read. See push notification configuration for more info.
BindingType
type: array[enum<string>]The push technology used by the User Binding resources to read. Can be: apn
, gcm
, or fcm
. See push notification configuration for more info.
gcm
apn
fcm
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}/Users/{UserSid}/Bindings/{Sid}
The {UserSid}
value can be either the sid
or the identity
of the User resource to delete the User Channel resource from.
ServiceSid
type: SID<IS>The SID of the Service to delete the User Binding resource from.
^IS[0-9a-fA-F]{32}$
34
34
UserSid
type: stringThe SID of the User with the User Binding resources to delete. See push notification configuration for more info.
Sid
type: SID<BS>The SID of the User Binding resource to delete.
^BS[0-9a-fA-F]{32}$
34
34