---
title: "Modify live session user state"
method: POST
path: "/public/modify-user-state-in-live-event-session"
tags: ["Live"]
---

# Modify live session user state

`POST /public/modify-user-state-in-live-event-session`

Add or remove people from webrtc meeting stage. This will make the user a participant or instructor in a given live stream. Use this API to make certain user(s) instructors before the stream starts.

Authentication with the "FERMION-API-KEY" header is required to use this endpoint.

Rate limit: Maximum 60 requests in a window of 1m.

## Request body

- object
  - `data` object[], required
    - `data` object, required
      - `liveEventSessionId` string, required — ID of liveEventSession - You will find this in your dashboard
      - `userId` string, required — Your stable, internal userId in your database.
      - `action` union, required
        - object
          - `type` 'request-to-be-on-stage' | 'add-to-webrtc-meeting' | 'remove-from-webrtc-meeting' | 'blacklist-user', required
        - object
          - `type` 'update-permissions', required
          - `newPermissions` object, required
            - `isAllowedToShareScreen` boolean — If you set this to `true`, this user would be able to turn on their screen sharing. Leave blank to keep unchanged.
            - `isAllowedToTurnOnCamera` boolean — If you set this to `true`, this user would be able to turn on their camera. Leave blank to keep unchanged.
            - `isAllowedToTurnOnMicrophone` boolean — If you set this to `true`, this user would be able to turn on their microphone. Leave blank to keep unchanged.
            - `shouldAllowAdministrativeActions` boolean — If you set this to `true`, this user would be able to perform the following tasks - add/remove/ban people from livestream, close live stream chat, and end livestreaming event. They can also turn on their mic/camera/screenshare

## Response `200`

API Response Body

- object[]
  - `output` union, required
    - object
      - `status` 'ok', required
      - `data` object, required
    - object
      - `status` 'error', required
      - `errorMessage` string, required

---

[API](https://skmtc.net/fermion/apis/fermion-backend-api.md) · [All operations](https://skmtc.net/fermion/apis/fermion-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fermion/fermion-backend-api/revisions/7ce364c8820b/schema)