---
title: "Update a meeting's access permission settings"
method: PUT
path: "/public-api/v1/meetings/{meeting_id}/access_permission"
tags: ["meetings"]
---

# Update a meeting's access permission settings

`PUT /public-api/v1/meetings/{meeting_id}/access_permission`

## Request

- Base URL: `/` (relative, and the document’s source URL is not known)
- URL: `/public-api/v1/meetings/{meeting_id}/access_permission`
- Auth: HTTP bearer and API key in header `x-tenant-code`

Update the access permission of a video; returns the updated settings.

Sets the permission type (``access_permission``) and the accounts granted
access (``access_users``); returns ``{"access_permissions": {...}}``. 422 on
invalid input (at request validation). 404 if the video id is unknown or
an ``access_users`` entry does not resolve to a user in the tenant. 403 when
the caller is not allowed to modify the video's permissions.

## Path parameters

- `meeting_id` string, uuid, required

## Request body

- VideoAccessPermissionRequest: Request body for ``PUT /meetings/{id}/access_permission``. The settings are nested under ``access_permissions``. Unknown top-level fields are rejected.
  - `access_permissions` VideoAccessPermissionInput, required: The ``access_permissions`` object in an access-permission update request.
    - `access_permission` string, required: The access-permission type. One of: HOST, EVERYONE, ALL_USERS_FOR_TEAM_ENABLED_TENANTS. An unrecognized value is rejected with 422.
    - `access_users` VideoAccessUserRef[], required: Accounts granted access (relevant when the permission type restricts viewing to specific users). Required; send an empty list when no per-user grants apply. An ``account_id`` that does not resolve to a user in the tenant causes a 404.
      - `account_id` string, uuid, required

## Response `200`

The meeting's access-permission settings after the update.

- VideoAccessPermissionResponse: Response for ``PUT /meetings/{id}/access_permission``: the updated settings. The updated settings, nested under ``access_permissions``.
  - `access_permissions` VideoAccessPermissionSettings, required: The ``access_permissions`` object in an access-permission response.
    - `access_permission` string, required
    - `access_users` VideoAccessUser[], required
      - `account_id` string, uuid, required
      - `name` string, nullable
      - `deleted` boolean, nullable

## Other responses

- `400`: The tenant could not be resolved from the request.
- `401`: Error envelope (`public_api.unauthorized`).
- `403`: The request is not allowed for the current tenant or access configuration.
- `404`: Error envelope (`public_api.not_found`).
- `409`: Error envelope (`public_api.conflict`).
- `413`: The request body exceeds the maximum allowed size.
- `422`: Validation Error
- `429`: Rate limit exceeded. Wait for ``Retry-After`` seconds before retrying.
- `502`: Error envelope (`public_api.internal_error`).
- `503`: The request could not be served right now. Please retry.
- `504`: Error envelope (`public_api.request_timeout`).

---

[API](https://skmtc.dev/miitel/apis/miitel-public-api.md) - [All operations](https://skmtc.dev/miitel/apis/miitel-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/miitel/apis/miitel-public-api/revisions/961732756fa3?raw)