---
title: "Create an item (text and/or image)"
method: POST
path: "/api/rooms/{code}/items"
tags: ["items"]
---

# Create an item (text and/or image)

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

## Request

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

## Path parameters

- `code` string, required

## Headers

- `X-Room-Password` string
- `X-Owner-Token` string

## Response `200`

Created

- object
  - `item` Item
    - `id` string, uuid
    - `text` string, nullable
    - `device` string, nullable
    - `createdAt` integer: Milliseconds since epoch.
    - `updatedAt` integer, nullable
    - `edited` boolean
    - `hasImage` boolean
    - `imageUrl` string, uri: Present when hasImage is true.
    - `imageMime` string: Present when hasImage is true.
    - `imageSize` integer: Bytes. Present when hasImage is true.

## Other responses

- `401`: Room is password-protected
- `422`: Validation failed

---

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