100ms · Capability

100ms Server-Side API — Rooms

Provision, list, retrieve, update, and enable/disable persistent live-video rooms on 100ms. Rooms are the durable container for templates, recordings, sessions, and live streams. Self-contained Naftiko capability covering one 100ms business surface.

100ms Server-Side API — Rooms is a Naftiko capability published by 100ms, one of 8 capabilities the APIs.io network indexes for this provider. It bundles 2 operations across the GET and POST methods rooted at /v2/rooms.

The capability includes 2 read-only operations and 3 state-changing operations. Lead operation: List 100ms rooms. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include 100ms, Live Video, and Rooms.

Run with Naftiko 100msLive VideoRooms

What You Can Do

GET
Listrooms — List Rooms
/v2/rooms
POST
Createroom — Create Room
/v2/rooms

MCP Tools

hms-list-rooms

List 100ms rooms.

read-only idempotent
hms-create-room

Create a 100ms room.

hms-retrieve-room

Retrieve a 100ms room by id.

read-only idempotent
hms-update-room

Update a 100ms room.

hms-set-room-enabled

Enable or disable a 100ms room.

idempotent

Capability Spec

rooms.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: 100ms Server-Side API — Rooms
  description: 'Provision, list, retrieve, update, and enable/disable persistent live-video rooms on 100ms.
    Rooms are the durable container for templates, recordings, sessions, and live streams. Self-contained
    Naftiko capability covering one 100ms business surface.'
  tags:
  - 100ms
  - Live Video
  - Rooms
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    HMS_MANAGEMENT_TOKEN: HMS_MANAGEMENT_TOKEN
capability:
  consumes:
  - type: http
    namespace: rooms
    baseUri: https://api.100ms.live/v2
    description: 100ms Server-Side API — Rooms business capability.
    resources:
    - name: rooms
      path: /rooms
      operations:
      - name: listrooms
        method: GET
        description: List Rooms
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createroom
        method: POST
        description: Create Room
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: room
      path: /rooms/{room_id}
      operations:
      - name: retrieveroom
        method: GET
        description: Retrieve A Room
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: room_id
          in: path
          type: string
          required: true
      - name: updateroom
        method: POST
        description: Update A Room
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: room_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: room-enabled
      path: /rooms/{room_id}/enabled
      operations:
      - name: setroomenabled
        method: POST
        description: Disable Or Enable A Room
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: room_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: bearer
      value: '{{env.HMS_MANAGEMENT_TOKEN}}'
      placement: header
  exposes:
  - type: rest
    namespace: rooms-rest
    port: 8080
    description: REST adapter for 100ms Rooms.
    resources:
    - path: /v2/rooms
      name: rooms
      description: REST surface for rooms.
      operations:
      - method: GET
        name: listrooms
        description: List Rooms
        call: rooms.listrooms
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createroom
        description: Create Room
        call: rooms.createroom
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: rooms-mcp
    port: 9090
    transport: http
    description: MCP adapter for 100ms Rooms.
    tools:
    - name: hms-list-rooms
      description: List 100ms rooms.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: rooms.listrooms
      outputParameters:
      - type: object
        mapping: $.
    - name: hms-create-room
      description: Create a 100ms room.
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: rooms.createroom
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: hms-retrieve-room
      description: Retrieve a 100ms room by id.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: rooms.retrieveroom
      with:
        room_id: tools.room_id
      outputParameters:
      - type: object
        mapping: $.
    - name: hms-update-room
      description: Update a 100ms room.
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: rooms.updateroom
      with:
        room_id: tools.room_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: hms-set-room-enabled
      description: Enable or disable a 100ms room.
      hints: { readOnly: false, destructive: true, idempotent: true }
      call: rooms.setroomenabled
      with:
        room_id: tools.room_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.