---
title: "Update a Participant"
method: PUT
path: "/v2/Conversations/{ConversationId}/Participants/{id}"
tags: ["ConversationsV2Participant"]
---

# Update a Participant

`PUT /v2/Conversations/{ConversationId}/Participants/{id}`

Update an existing Participant

## Request body

- object
  - `name` string
  - `type` 'HUMAN_AGENT' | 'CUSTOMER' | 'AI_AGENT' | 'AGENT' | 'UNKNOWN' — Type of Participant in the Conversation.
  - `profileId` string
  - `addresses` object[]
    - `channel` 'VOICE' | 'SMS' | 'RCS' | 'WHATSAPP' | 'CHAT', required — Channel type for a Communication address.
    - `address` string, required
    - `channelId` string

## Response `200`

OK

- object
  - `id` string, required — Participant ID.
  - `conversationId` string, required — Conversation ID.
  - `accountId` string, required — Account ID.
  - `name` string, required — Participant display name.
  - `type` 'HUMAN_AGENT' | 'CUSTOMER' | 'AI_AGENT' | 'AGENT' | 'UNKNOWN' — Type of Participant in the Conversation.
  - `profileId` string — Profile ID. Note: This field is only resolved for `CUSTOMER` participant types, not for `HUMAN_AGENT` or `AI_AGENT` participants.
  - `addresses` ConversationsV2Address[] — Communication addresses for this Participant. Address format varies by channel: - SMS/VOICE: E.164 phone number (such as "+18005550100") - EMAIL: Email address (such as "user@example.com") - WHATSAPP: Phone number with whatsapp prefix (such as "whatsapp:+18005550100") - RCS: Sender ID or phone number with rcs prefix (such as "rcs:brand_acme_agent" or "rcs:+18005550100")
    - `channel` 'VOICE' | 'SMS' | 'RCS' | 'WHATSAPP' | 'CHAT', required — Channel type for a Communication address.
    - `address` string, required — The address value formatted according to channel type: - SMS/VOICE: E.164 phone number (such as "+18005550100") - WHATSAPP: Phone number with whatsapp prefix (such as "whatsapp:+18005550100") - RCS: Sender ID or phone number with rcs prefix (such as "rcs:brand_acme_agent" or "rcs:+18005550100") - CHAT: Customer-defined string identifier
    - `channelId` string — Channel-specific ID for correlating Communications.
  - `createdAt` string, date-time — Timestamp when this Participant was created.
  - `updatedAt` string, date-time — Timestamp when this Participant was last updated.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/twilio/apis/conversations-v2.md) · [All operations](https://skmtc.dev/twilio/apis/conversations-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/conversations-v2/revisions/f039dce07916/schema)