Update participant by identifier key and value
Update a participant's status in the conversation by specifying their identifier key and value. For more information on identifier keys and values, please refer to the "Conversation Participants" page.
Authorizations
Path parameters
workspaceIdstring · uuidRequiredExample:
The workspace ID
b4e02c85-c6d2-4b15-8885-e09671799c61
conversationIdstring · uuidRequiredExample:
The conversation ID
67e4d358-ca94-421e-98b7-448860df9d33
identifierKeystring · min: 1RequiredExample:
The identifier type of the channel, such as emailaddress
or phonenumber
emailaddress
identifierValuestring · min: 1RequiredExample:
A value that uniquely identifies a recipient in the channel, such as an email address or a phone number
[email protected]
Body
statusstring · enum | nullableOptionalPossible values:
Participant status in the conversation.
Responses
200
Participant was updated
application/json
404
The resource specified in the URL was not found
application/json
409
The resource is in a conflicting state
application/json
422
The request body did not pass validation
application/json
patch
PATCH /workspaces/{workspaceId}/conversations/{conversationId}/participants/{identifierKey}/{identifierValue} HTTP/1.1
Host: api.bird.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 20
{
"status": "pending"
}
{
"id": "cb22b001-6226-4d7c-acdd-7414b2bcdbaf",
"displayName": "John Doe",
"avatarUrl": "https://example.bird.com/avatar-url",
"contact": {
"identifierKey": "emailaddress",
"identifierValue": "[email protected]",
"platformAddress": "[email protected]",
"platformAddressSelector": "attributes.workEmail"
},
"type": "user",
"status": "active"
}
Examples
curl -X PATCH "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/conversations/c9c60caa-eaf5-4628-9687-91de4d452bfa/participants/emailaddress/[email protected]" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd" \
-d '{
"status": "active"
}'
Last updated
Was this helpful?