Update participant by ID
Update a participant's status in the conversation
Authorizations
Path parameters
workspaceIdstring · uuidRequiredExample:
The workspace ID
b4e02c85-c6d2-4b15-8885-e09671799c61
conversationIdstring · uuidRequiredExample:
The conversation ID
67e4d358-ca94-421e-98b7-448860df9d33
conversationParticipantIdstring · min: 1RequiredExample:
The ID that refers to the conversation participant (e.g. the contact ID if the participant is a contact)
274bd6ff-3295-49a0-a02d-651fb661d7fb
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/{conversationParticipantId} 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/280b4743-d753-4767-8516-2fd506e29953" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd" \
-d '{
"status": "active"
}'
Last updated
Was this helpful?