> For complete lifecycle-event payload schemas and examples, use the canonical overview: Session /api/sessions; Room lifecycle, members, and room playback /api/rooms; Session playback /api/playback; Recording /api/recording; DTMF /api/keypad-input; Messages /api/messages; WebSocket Session /api/web-socket. Use /api/event-delivery for transport behavior. Endpoint pages name relevant events, but these overviews are the canonical references.

# RoomMember

> Room-member API overview; complete member lifecycle-event schemas and examples are in the Room overview.

A `RoomMember` represents a Session's membership in one Room. Its `uuid` matches
the corresponding `Session.session_uuid`.

## When to use

Use Room members to add or remove individual participants and control their
mute state and volume.

## Methods

* [List room members](api:voice-api:GET/api/v1/rooms/\{room_id}/members)
* [Add a room member](api:voice-api:POST/api/v1/rooms/\{room_id}/members)
* [Get room member details](api:voice-api:GET/api/v1/rooms/\{room_id}/members/\{uuid})
* [Remove a room member](api:voice-api:DELETE/api/v1/rooms/\{room_id}/members/\{uuid})
* [Mute a room member](api:voice-api:POST/v1/sessions/\{uuid}/room/mute)
* [Unmute a room member](api:voice-api:POST/v1/sessions/\{uuid}/room/unmute)
* [Set room-member volume](api:voice-api:POST/v1/sessions/\{uuid}/room/volume)

Use the
[`room.member.voice_activity_changed`](/api/rooms#roommembervoice_activity_changed)
webhook to receive voice-activity transitions. These events are emitted only
when the Room was created with `voice_activity_events: true`.

## Choose the initial mute state

If a member must join muted, send `"muted": true`. If you omit `muted` or set it
to `false`, the member joins unmuted.

## Resource representation

### The RoomMember resource

```json
{
  "muted": true,
  "uuid": "string"
}
```

## Properties

### Schema (`RoomMember`)

```yaml
components:
  schemas:
    RoomMember:
      type: object
      properties:
        muted:
          type: boolean
          description: Whether the member is currently muted in the room.
        uuid:
          type: string
          description: Session UUID of the member.
      required:
        - muted
        - uuid
      title: RoomMember
```