---
title: "Update Chat Access"
method: PATCH
path: "/chats/access"
tags: ["chats"]
---

# Update Chat Access

`PATCH /chats/access`

This endpoint overrides the default chat access for a user. This can only be used to provide access to users for a chat and cannot be used to remove access.

## Headers

- `x-phone` string

## Request body

- object
  - `access` object, required — - An object mapping user emails to boolean access flags - Note: This replaces the current override chat access property of the chats Example: `{ "alice@gmail.com": true, "bob@gmail.com": false }`
  - `chat_ids` string[], required — - An array of chat_ids to update
  - `replace` boolean — - When true, the existing chat access overrides are fully replaced with the access map provided in this request - When false, the provided access values are merged into the existing overrides (only updating the specified users without removing others)

## Response `204`

204 OK

- object — _204 No Content_

## Other responses

- `422` — 422 Invalid body

---

[API](https://skmtc.net/periskope/apis/api-local.md) · [All operations](https://skmtc.net/periskope/apis/api-local/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/periskope/api-local/versions/f2738ced87d8/schema)