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

# Conversations API

> How durable messaging and durable execution work together.

The Conversations API stores messages, runs, and events for agent-facing chat.

<div className="cloud-architecture-diagram">
  <div className="cloud-architecture-layer">
    <div className="cloud-architecture-title">Conversations API</div>

    <div className="cloud-architecture-service-groups conversation-api-capability-groups">
      <div className="cloud-architecture-service-group">
        <div className="cloud-architecture-service-title">Durable messaging</div>

        <div className="cloud-architecture-grid two">
          <div>Conversations</div>
          <div>Messages</div>
        </div>
      </div>

      <div className="cloud-architecture-service-group">
        <div className="cloud-architecture-service-title">Durable execution</div>

        <div className="cloud-architecture-grid two">
          <div>Runs</div>
          <div>Events</div>
        </div>
      </div>
    </div>
  </div>
</div>

## Core model

| Layer                                                          | Stores                                                             | Use it for           |
| -------------------------------------------------------------- | ------------------------------------------------------------------ | -------------------- |
| [Durable messaging](/cloud/conversation-api/durable-messaging) | Conversations, messages, branches, read state, and input requests. | What the user sees.  |
| [Durable execution](/cloud/conversation-api/durable-execution) | Runs, events, checkpoints, resume, and completion state.           | What the system did. |

## Why both exist

A message stores visible chat state.

A run stores the work that produced, streamed, resumed, cancelled, or failed that response.

## Contents

| Page                                                             | Use it to understand                                       |
| ---------------------------------------------------------------- | ---------------------------------------------------------- |
| [Durable messaging](/cloud/conversation-api/durable-messaging)   | Conversation state and message structure.                  |
| [Durable execution](/cloud/conversation-api/durable-execution)   | Runs, jobs, workflows, events, and resume behavior.        |
| [Architecture and flow](/cloud/conversation-api/lifecycle)       | How a message becomes a run and final answer.              |
| [Run lineage](/cloud/conversation-api/datastores-lineage)        | How conversations, messages, runs, and child work connect. |
| [Events and streaming](/cloud/conversation-api/streaming-events) | SSE, AG-UI events, durable events, and notifications.      |
| [Authorization](/cloud/conversation-api/authorization)           | Access boundaries for conversations and runs.              |
| [Connect an agent](/cloud/conversation-api/connect-agent)        | Runtime contract for developer-provided agents.            |