> ## Documentation Index
> Fetch the complete documentation index at: https://getoverlay.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversations Workflow

> Create, update, stream, and stop web conversations.

Use the typed `@overlay/api-client` conversation methods when possible.

Typical flow:

1. Create or load a conversation with `/api/v1/conversations`.
2. Add user-visible messages with `/api/v1/conversations/message`.
3. Run an Act turn with `/api/v1/conversations/act`.
4. Verify stream resume credentials with `/api/v1/conversations/stream-auth` when the client reconnects after a disconnect.
5. Stop an active turn with `/api/v1/conversations/stop`.

Conversation messages may contain text, file references, generated UI data, and tool invocation parts. Keep generated and persisted message shapes aligned with `@overlay/app-core`.

For title generation:

```http theme={null}
POST /api/v1/generate-title
```