---
title: "Update a conference participant"
method: PATCH
path: "/conferences/{id}/participants/{participant_id}"
tags: ["Conference Commands"]
---

# Update a conference participant

`PATCH /conferences/{id}/participants/{participant_id}`

Update properties of a conference participant.

## Path parameters

- `id` string, uuid, required
- `participant_id` string, required

## Request body

- UpdateConferenceParticipantRequest
  - `end_conference_on_exit` boolean — Whether the conference should end when this participant exits.
  - `soft_end_conference_on_exit` boolean — Whether the conference should soft-end when this participant exits. A soft end will stop new participants from joining but allow existing participants to remain.
  - `beep_enabled` 'always' | 'never' | 'on_enter' | 'on_exit' — Whether entry/exit beeps are enabled for this participant.

## Response `200`

Successful response

- ConferenceParticipantResource
  - `data` ConferenceParticipant
    - `id` string — Uniquely identifies the participant.
    - `call_control_id` string — Unique identifier and token for controlling the participant's call leg.
    - `call_leg_id` string — Unique identifier for the call leg.
    - `conference_id` string — Unique identifier for the conference.
    - `label` string — Label assigned to the participant when joining.
    - `status` 'joining' | 'joined' | 'left' — Status of the participant.
    - `muted` boolean — Whether the participant is muted.
    - `on_hold` boolean — Whether the participant is on hold.
    - `whisper_call_control_ids` string[] — List of call control IDs this participant is whispering to.
    - `created_at` string, date-time — Timestamp when the participant joined.
    - `updated_at` string, date-time — Timestamp when the participant was last updated.
    - `end_conference_on_exit` boolean — Whether the conference ends when this participant exits.
    - `soft_end_conference_on_exit` boolean — Whether the conference soft-ends when this participant exits.

## Other responses

- `401` — Unauthorized. Authentication failed - the required authentication headers were either invalid or not included in the request.
- `404` — Resource not found. The requested resource does not exist. Common causes include: invalid call_control_id, conference not found, audio file not found, or recording not found.
- `422` — Unprocessable entity. The request was well-formed but could not be processed due to semantic errors. This includes validation errors, invalid parameter values, call state errors, conference errors, queue errors, recording/transcription errors, and business logic violations.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)