Service Binding Resource
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).
ServiceBinding properties
Each Binding resource has the following properties:
| Resource Properties in REST API format | |
|---|---|
sid
|
A 34 character string that uniquely identifies this resource. |
account_sid
|
The unique ID of the Account responsible for this binding. |
chat_service_sid
|
The SID of the Conversation Service the Binding resource is associated with. |
credential_sid
|
The SID of the Credential for the binding. See push notification configuration for more info. |
date_created
|
The date that this resource was created. |
date_updated
|
The date that this resource was last updated. |
endpoint
|
The unique endpoint identifier for the Binding. The format of this value depends on the |
identity
|
The application-defined string that uniquely identifies the Conversation User within the Conversation Service. See access tokens for more info. |
binding_type
|
The push technology to use for the Binding. Can be: |
message_types
|
The Conversation message types the binding is subscribed to. |
url
|
An absolute API resource URL for this binding. |
Fetch a ServiceBinding resource
https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Bindings/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
chat_service_sid
Path
|
The SID of the Conversation Service the Binding resource is associated with. |
sid
Path
|
A 34 character string that uniquely identifies this resource. |
Example 1
Read multiple ServiceBinding resources
https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Bindings
Parameters
| Parameters in REST API format | |
|---|---|
chat_service_sid
Path
|
The SID of the Conversation Service the Binding resource is associated with. |
binding_type
Optional
|
The push technology used by the Binding resources to read. Can be: |
identity
Optional
|
The identity of a Conversation User this binding belongs to. See access tokens for more details. |
Example 1
Delete a ServiceBinding resource
https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Bindings/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
chat_service_sid
Path
|
The SID of the Conversation Service to delete the Binding resource from. |
sid
Path
|
The SID of the Binding resource to delete. |
Example 1
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
