---
title: "Probe room status"
method: GET
path: "/api/rooms/{code}/status"
tags: ["rooms"]
---

# Probe room status

`GET /api/rooms/{code}/status`

## Request

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

Cheap existence + lock-state check. Creates the room if it doesn't exist (returns 201).

## Path parameters

- `code` string, required

## Headers

- `X-Owner-Token` string

## Response `200`

Room exists

- object
  - `exists` boolean
  - `locked` boolean
  - `owner` boolean

## Other responses

- `201`: Room created on demand

---

[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)