Retrieve a list of all Conversations that this Participant belongs to by identity
Service Participant Conversations resource represents a list of Conversations that this Participant belongs to belonging to a specific conversation service.
Retrieve a list of all Conversations that this Participant belongs to by identity or by address. Only one parameter should be specified.
Path parameters
-
The SID of the Conversation Service the Participant Conversations resource is associated with.
Query parameters
-
Identity string
A unique string identifier for the conversation participant as Conversation User. This parameter is non-null if (and only if) the participant is using the Conversations SDK to communicate. Limited to 256 characters.
-
Address string
A unique string identifier for the conversation participant who's not a Conversation User. This parameter could be found in messaging_binding.address field of Participant resource. It should be url-encoded.
-
PageSize integer
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
.
curl \
-X GET https://conversations.twilio.com/v1/Services/{ChatServiceSid}/ParticipantConversations \
--user "username:password"
{
"conversations": [
{
"account_sid": "string",
"chat_service_sid": "string",
"conversation_attributes": "string",
"conversation_created_by": "string",
"conversation_date_created": "2023-05-04T09:42:00+00:00",
"conversation_date_updated": "2023-05-04T09:42:00+00:00",
"conversation_friendly_name": "string",
"conversation_sid": "string",
"conversation_state": "inactive",
"conversation_unique_name": "string",
"links": {},
"participant_identity": "string",
"participant_sid": "string",
"participant_user_sid": "string"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}
{
"conversations": [
{
"account_sid": "string",
"chat_service_sid": "string",
"conversation_attributes": "string",
"conversation_created_by": "string",
"conversation_date_created": "2024-05-04T09:42:00+00:00",
"conversation_date_updated": "2024-05-04T09:42:00+00:00",
"conversation_friendly_name": "string",
"conversation_sid": "string",
"conversation_state": "inactive",
"conversation_unique_name": "string",
"links": {},
"participant_identity": "string",
"participant_sid": "string",
"participant_user_sid": "string"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}