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

# Threads

> Conversations are threads — created automatically, readable any time.

A **thread** is one conversation between an end user and your agent. Threads
are created automatically when you send a message without a `thread_id` — the
created id comes back in the response, and you pass it on subsequent messages
to continue the conversation.

<Info>
  Coming from an earlier integration? Threads are what used to be called
  *tasks*, and there is no longer a separate "create task" step.
</Info>

***

## Read a thread's transcript

```bash cURL theme={"dark"}
curl "https://api-v3.aui.io/apollo-api/messaging/v1/threads/{threadId}/messages" \
  -H "Authorization: Bearer <access_token>"
```

### GET `/messaging/v1/threads/{threadId}/messages`

Returns the thread's full transcript in chronological order — one entry per
message, both the user's and the agent's.

<ResponseExample>
  ```json 200 theme={"dark"}
  [
    {
      "id": "507f1f77bcf86cd799439011",
      "created_at": "2026-07-13T14:02:11Z",
      "text": "I want to dispute a charge from May 30th",
      "sender": { "id": "my-user-123", "type": "user" },
      "cards": [],
      "followup_suggestions": []
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "created_at": "2026-07-13T14:02:14Z",
      "text": "I can help with that. Our dispute window is 8 days...",
      "sender": { "type": "agent" },
      "cards": [],
      "followup_suggestions": ["What other options do I have?"]
    }
  ]
  ```
</ResponseExample>

***

## Welcome message

Open your conversation UI with the agent's configured greeting — before any
message has been sent:

```bash cURL theme={"dark"}
curl "https://api-v3.aui.io/apollo-api/messaging/v1/welcome-message" \
  -H "Authorization: Bearer <access_token>"
```

### GET `/messaging/v1/welcome-message`

Returns the welcome message of your agent's live version:

```json 200 theme={"dark"}
{ "welcome_message": "Hi! How can I help you today?" }
```

***

## Follow-up suggestions

Generate suggested next prompts from a context you provide — useful for
offering the end user quick next questions:

```bash cURL theme={"dark"}
curl -X POST "https://api-v3.aui.io/apollo-api/messaging/v1/followup-suggestions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -d '{ "context": { "topic": "order tracking" } }'
```

### POST `/messaging/v1/followup-suggestions`

<ParamField body="context" type="object">
  The context the suggestions are generated from — any JSON object describing
  where the user is in your product or conversation.
</ParamField>

```json 200 theme={"dark"}
{
  "suggestions": [
    "Where is my order?",
    "Can I change the delivery address?"
  ]
}
```

<Tip>
  The agent's replies also carry `followup_suggestions` inline — this endpoint
  is for generating suggestions *outside* a turn, e.g. when the user lands on a
  page.
</Tip>

***

## Managing threads

Listing, filtering, renaming, and auditing threads across your organization
live on the management surface — see
[Management → Threads](/api/management/threads).