> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.telekesher.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.telekesher.dev/_mcp/server.

# Room

A `Room` is a shared audio resource identified by `room_id`. Room playback and
a room [Recording](/api/recording) are reflected in the full resource
returned by the get method.

## Methods

* [Create a room](api:voice-api:POST/api/v1/rooms)
* [List rooms](api:voice-api:GET/api/v1/rooms)
* [Get room details](api:voice-api:GET/api/v1/rooms/\{room_id})
* [Delete a room](api:voice-api:DELETE/api/v1/rooms/\{room_id})

The list method returns `RoomSummary` projections. Use the get method when you
need the complete `Room` representation shown below.

## Resource representation

### The Room resource

```json
{
  "created_at": "2023-01-01T00:00:00Z",
  "member_count": 0,
  "playback_operation_uuid": "string",
  "playback_status": "stopped",
  "playback_urls": [
    "string"
  ],
  "playback_volume": 0,
  "room_id": "string"
}
```

## Properties

### Schema (`Room`)

```yaml
components:
  schemas:
    RoomPlaybackStatus:
      type: string
      enum:
        - stopped
        - playing
        - paused
      title: RoomPlaybackStatus
    Room:
      type: object
      properties:
        created_at:
          type: string
          format: date-time
        member_count:
          type: integer
          description: Current number of members in the room.
        playback_operation_uuid:
          type: string
        playback_status:
          $ref: '#/components/schemas/RoomPlaybackStatus'
        playback_urls:
          type: array
          items:
            type: string
        playback_volume:
          type: integer
          default: 0
          description: |-
            Current room playback volume (0-200). A newly created room reports
            `0` until a room playback volume command sets an explicit value.
        room_id:
          type: string
      required:
        - created_at
        - member_count
        - playback_operation_uuid
        - playback_status
        - playback_urls
        - playback_volume
        - room_id
      title: Room
```