Update an existing participant in the conversation
A Participant resource represents a member of the conversation.
Update an existing participant in the conversation
Headers
-
X-Twilio-Webhook-Enabled string
The X-Twilio-Webhook-Enabled HTTP request header
Values are
true
orfalse
.
Path parameters
-
The unique ID of the Conversation for this participant.
-
A 34 character string that uniquely identifies this resource.
Body
-
Attributes string
An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. Note that if the attributes are not set "{}" will be returned.
-
DateCreated string(date-time)
The date that this resource was created.
-
DateUpdated string(date-time)
The date that this resource was last updated.
-
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.
-
LastReadMessageIndex integer | null
Index of last “read” message in the Conversation for the Participant.
-
LastReadTimestamp string
Timestamp of last “read” message in the Conversation for the Participant.
-
The address of the Twilio phone number that is used in Group MMS. 'null' value will remove it.
-
The address of the Twilio phone number that the participant is in contact with. 'null' value will remove it.
-
RoleSid string
The SID of a conversation-level Role to assign to the participant.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^RL[0-9a-fA-F]{32}$
.
curl \
-X POST https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Participants/{Sid} \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "X-Twilio-Webhook-Enabled: true" \
-d 'Attributes=string&DateCreated=2023-05-04T09%3A42%3A00%2B00%3A00&DateUpdated=2023-05-04T09%3A42%3A00%2B00%3A00&Identity=string&LastReadMessageIndex=42&LastReadTimestamp=string&MessagingBinding.ProjectedAddress=string&MessagingBinding.ProxyAddress=string&RoleSid=string'
# Headers
X-Twilio-Webhook-Enabled: true
# Payload
{
"Attributes": "string",
"DateCreated": "2023-05-04T09:42:00+00:00",
"DateUpdated": "2023-05-04T09:42:00+00:00",
"Identity": "string",
"LastReadMessageIndex": 42,
"LastReadTimestamp": "string",
"MessagingBinding.ProjectedAddress": "string",
"MessagingBinding.ProxyAddress": "string",
"RoleSid": "string"
}
# Headers
X-Twilio-Webhook-Enabled: true
# Payload
{
"Attributes": "string",
"DateCreated": "2024-05-04T09:42:00+00:00",
"DateUpdated": "2024-05-04T09:42:00+00:00",
"Identity": "string",
"LastReadMessageIndex": 42,
"LastReadTimestamp": "string",
"MessagingBinding.ProjectedAddress": "string",
"MessagingBinding.ProxyAddress": "string",
"RoleSid": "string"
}
{
"account_sid": "string",
"attributes": "string",
"conversation_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"identity": "string",
"last_read_message_index": 42,
"last_read_timestamp": "string",
"role_sid": "string",
"sid": "string",
"url": "https://example.com"
}
{
"account_sid": "string",
"attributes": "string",
"conversation_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"identity": "string",
"last_read_message_index": 42,
"last_read_timestamp": "string",
"role_sid": "string",
"sid": "string",
"url": "https://example.com"
}