# Responses API

The Responses API is the root-mounted local ingress for room-backed sessions.

Current scope is intentionally narrow:

- one route: `POST /v1/responses`
- room-backed session continuity via `room_id`
- one queued input per call
- no tool calls yet
- SSE streaming when `stream=true`

## Session Model

A room is the durable session authority.

- omit `room_id` to start a new session
- provide `room_id` to continue an existing session
- room ids are UUIDs minted by the room runtime

Each `POST /v1/responses` call creates one response object and appends one user
message into the target room.

## Endpoints

| Method | Path | Purpose |
|--------|------|---------|
| POST | `/v1/responses` | Create one room-backed response request |

## Notes

- This surface is protected by the normal Abbotik bearer token.
- Non-streaming requests return a queued response object immediately.
- Streaming requests return SSE scoped to the submitted room turn.
- Actual assistant output still lives in room history and room events.
- `tools`, `instructions`, and `previous_response_id` are not implemented yet.