DailyParticipantPermissions

DailyParticipantPermissions describes what a participant is allowed to do in a call. It is exposed as DailyParticipant.permissions and can be updated at runtime via updateParticipant().

interface DailyParticipantPermissions {
  hasPresence: boolean;
  canSend: boolean | Set<'video' | 'audio' | 'screenVideo' | 'screenAudio' | 'customVideo' | 'customAudio'>;
  canReceive: DailyParticipantCanReceivePermission;
  canAdmin: boolean | Set<'participants' | 'streaming' | 'transcription'>;
}

Properties

hasPresence

boolean

When false, the participant is hidden from all other participants. They do not appear in participants() for others, cannot be seen or heard, and their events are not broadcast. Useful for silent observers or bots.

canSend

boolean | Set<string>

Controls which media tracks the participant may publish. true allows all, false blocks all, or a Set of specific track types.

Show allowed values

"video"

Camera video track.

"audio"

Microphone audio track.

"screenVideo"

Screen share video.

"screenAudio"

Screen share audio.

"customVideo"

Any custom video track started with startCustomTrack().

"customAudio"

Any custom audio track started with startCustomTrack().

canReceive

DailyParticipantCanReceivePermission

Controls which participants’ media this participant may subscribe to. Overrides cascade from most general (base) to most specific (byParticipantId).

Show canReceive properties

base

boolean | object

Default receive permission that applies to all remote participants unless overridden. true allows all media, false blocks all. Or provide a granular object:

{
  video: boolean;
  audio: boolean;
  screenVideo: boolean;
  screenAudio: boolean;
  customVideo: { '*': boolean; [trackName: string]: boolean };
  customAudio: { '*': boolean; [trackName: string]: boolean };
}

byUserId

object

Per-user_id overrides. A mapping from user_id to true, false, or a partial per-media-type object. Overrides base for the matched participant.

byParticipantId

object

Per-session_id overrides. A mapping from session_id to true, false, or a partial per-media-type object. Overrides both base and byUserId for the matched participant.

canAdmin

boolean | Set<string>

Controls which administrative capabilities the participant holds. true grants all, false grants none, or a Set of specific capabilities.

Show allowed values

"participants"

Can mute, eject, and update permissions of other participants. Can also admit waiting participants.

"streaming"

Can start and stop cloud recordings and live streams.

"transcription"

Can start and stop transcription.

Types

DailyParticipant

Methods

updateParticipant()

Events

participant-updated

REST API

Guides

Permissions

DailyParticipant DailyStreamingLayoutConfig

​Properties

​See also