updateParticipant()

updateParticipant(sessionId, updates) Modifies a participant, either by sending a message to change their state, or by changing how you see them locally. Returns this for chaining.

Parameters

sessionId

string

required

The participant’s session_id, or 'local' for the local participant.

updates

DailyParticipantUpdateOptions

required

An object describing what to update. All fields are optional.

Hide properties

setAudio

boolean

Mute (false) or unmute (true) the participant’s microphone. Requires the caller to be a participant admin ('participants' in canAdmin). Silently ignored if not possible or if there is no active meeting.

For the local participant, prefer setLocalAudio() — though both work. For remote participants, admins can mute (false) but only meeting owners can unmute (true), and doing so is strongly discouraged as a privacy concern.

setVideo

boolean

Enable (true) or disable (false) the participant’s camera. Requires participant admin permission. Silently ignored if not possible.

For the local participant, prefer setLocalVideo() — though both work.

Remotely controlling another participant’s camera or microphone is a potential privacy issue. Use deliberately. Browsers require the user to have explicitly allowed mic/camera access at least once.

Stop the participant’s active screen share. Only false is accepted. Requires participant admin permission. Has no effect when sessionId is 'local'.

eject

true

Remove the participant from the call. Only true is accepted. Requires participant admin permission.

setSubscribedTracks

DailyTrackSubscriptionOptions

Controls which tracks you receive from this participant. SFU mode only — not supported in Daily Prebuilt. Requires subscribeToTracksAutomatically to be false; throws an error if it is true.Accepts true, false, 'staged', 'avatar', or a per-track object:

call.updateParticipant('session-id', {
  setSubscribedTracks: {
    audio: true,
    video: 'staged',
    screenVideo: false,
    screenAudio: false,
  },
});

true — subscribe: set up a consumer connection and start transmitting data
false — unsubscribe: tear down the consumer connection
'staged' — set up the consumer connection but pause data transmission; no bandwidth cost, but going from 'staged' → true is faster than subscribing from scratch
'avatar' — subscribe to audio only, receive a placeholder for video

When supporting large calls, subscribe to tracks you’re rendering, stage tracks on adjacent pages, and unsubscribe from everything else.

updatePermissions

DailyParticipantPermissionsUpdate

Updates the participant’s in-call permissions (canSend, canReceive, hasPresence, canAdmin). Requires the caller to be a participant admin. See DailyParticipantPermissions for the full shape and behavior of each field.

call.updateParticipant('session-id', {
  updatePermissions: {
    canSend: new Set(['video', 'audio']),
    canReceive: { byUserId: { foo: false } },
    hasPresence: false,
    canAdmin: new Set(['participants', 'streaming']),
  },
});

Return value

Returns this (the DailyCall instance) for chaining.

Types

DailyParticipantPermissions

Methods

Events

Guides

REST API

Meeting token: permissions

updateLiveStreaming()updateParticipants()

​Parameters

​Return value

​See also

Types

Methods

Events

Guides

REST API

Parameters

Return value

See also