---
title: "Open an assistant conversation. `name` is normally omitted -- the first turn names the room from what was said. With `entryId` this is get-or-create: the caller's existing conversation about that entry, or a new one."
method: POST
path: "/chat/rooms"
tags: ["Chat"]
---

# Open an assistant conversation. \`name\` is normally omitted -- the first turn names the room from what was said. With \`entryId\` this is get-or-create: the caller's existing conversation about that entry, or a new one.

`POST /chat/rooms`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/chat/rooms`
- Auth: HTTP bearer

## Request body

- AssistantRoomCreateRequest
  - `name` string
  - `entryId` string, uuid

## Response `200`

The caller already had a conversation about this entry

- object
  - `data` AssistantRoom, required
    - `id` string, uuid, required
    - `name` string, nullable, required
    - `entryId` string, uuid, nullable, required
    - `messageCount` integer, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `meta` object, required
    - `requestId` string, required

## Other responses

- `201`: Created
- `403`: The caller may not read that entry
- `404`: No such entry

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)