---
title: "Set or remove the room password (owner only)"
method: POST
path: "/api/rooms/{code}/password"
tags: ["rooms"]
---

# Set or remove the room password (owner only)

`POST /api/rooms/{code}/password`

## Request

- Base URL: `https://useclippy.cc`
- URL: `https://useclippy.cc/api/rooms/{code}/password`
- Auth: none declared

## Path parameters

- `code` string, required

## Headers

- `X-Owner-Token` string

## Request body

- object
  - `password` string, nullable: Set to null to remove the password.

## Response `200`

Updated

- object
  - `ok` boolean
  - `locked` boolean

## Other responses

- `403`: Owner token missing or invalid

---

[API](https://skmtc.dev/useclippy/apis/clippy-api.md) · [All operations](https://skmtc.dev/useclippy/apis/clippy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useclippy/apis/clippy-api/revisions/9635a19d0ab8?raw)