Update participant by v key and value

Update conversation participant by contact

patch

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

accessKey

HTTPRequired

Uses the Authorization header: 'AccessKey ' followed by your access key token

Path parameters

workspaceIdstring · uuidRequired

The unique identifier of the workspace.

conversationIdstring · uuidRequired

The conversation ID

Example: 67e4d358-ca94-421e-98b7-448860df9d33

identifierKeystring · min: 1Required

The identifier type of the channel, such as emailaddress or phonenumber

Example: emailaddress

identifierValuestring · min: 1Required

A value that uniquely identifies a recipient in the channel, such as an email address or a phone number

Example: [email protected]

Body

application/json

statusstring · enum · nullableOptional

Participant status in the conversation.

Possible values:

Responses

200

Participant was updated

application/json

avatarUrlstringOptional

conversationIdstring · uuidOptional

createdAtstring · date-timeOptional

displayNamestringOptional

idstringRequired

resourceUristringOptional

statusstring · enumOptionalPossible values:

typestring · enumRequiredPossible values:

updatedAtstring · date-timeOptional

404

The requested resource was not found.

application/json

409

The request conflicts with the current state of the resource.

application/json

422

The request contains invalid parameters or body fields.

application/json

patch

/workspaces/{workspaceId}/conversations/{conversationId}/participants/{identifierKey}/{identifierValue}

HTTPcURLJavaScriptPython

PATCH /workspaces/{workspaceId}/conversations/{conversationId}/participants/{identifierKey}/{identifierValue} HTTP/1.1
Host: api.bird.com
Authorization: AccessKey YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "status": "pending"
}

{
  "avatarUrl": "text",
  "contact": {
    "identifierKey": "text",
    "identifierValue": "text",
    "platformAddress": "text",
    "platformAddressSelector": "text"
  },
  "conversationId": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-05-16T18:30:56.054Z",
  "displayName": "text",
  "id": "text",
  "resourceUri": "text",
  "status": "invited",
  "type": "user",
  "updatedAt": "2026-05-16T18:30:56.054Z"
}

Examples

Request

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"
}'

Response (200 - OK)