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

# Inspect conversations

> List saved conversation records, inspect transcripts and summaries, and retrieve audio when a recording is available.

Use saved conversation records to inspect what was captured and identify the agent configuration associated with a record. This guide reads existing data; it does not initiate a new conversation or generate analysis.

<Frame caption="Recording pending: Inspect a saved conversation. Follow the written guide below.">
  <img src="https://mintcdn.com/threetonelabs-c2efc9c8/RV32i5440UZIaFHA/images/tutorials/recording-pending.webp?fit=max&auto=format&n=RV32i5440UZIaFHA&q=85&s=55f66d2eef49d8c92c9ac46f84bace35" alt="Recording pending for Inspect a saved conversation. No playable video is available yet." width="1600" height="900" className="w-full h-auto aspect-video" loading="lazy" noZoom data-path="images/tutorials/recording-pending.webp" />
</Frame>

## Before you begin

You need access to the workspace and an existing conversation record. Use a permitted API key for API reads. Sample records can help you understand the response shape, but they are not evidence of a real conversation.

## Choose a representation

| Operation | Use it when |
| - | - |
| [List conversations](/api-reference/agents-platform/list-conversations) | You need a filtered, paginated set of saved records. |
| [Conversation details](/api-reference/agents-platform/get-conversation-details) | You need the transcript, metadata, and any analysis already stored. |
| [Conversation summary](/api-reference/agents-platform/get-conversation-summary) | You need a smaller response and can account for omitted messages. |
| [Conversation audio](/api-reference/agents-platform/get-conversation-audio) | A recording exists and you are permitted to retrieve it. |

## Inspect a record

<Steps>
  <Step title="Filter the list">
    Choose the agent, branch, version, or time filters relevant to your review. Set `page_size` and request the first page.

    The response includes `conversations`, `has_more`, and `next_cursor`. When more records are available, pass the returned cursor to the next request rather than assuming the first page is complete.
  </Step>

  <Step title="Read the details">
    Open the intended conversation ID. Review its status, metadata, transcript, and associated `branch_id` and `version_id` when present.

    Use those identifiers to connect the record to the saved configuration. A conversation status describes that record; it does not establish that all current execution paths are available.
  </Step>

  <Step title="Check summary coverage">
    The summary defaults to a maximum of 40 messages. Inspect `messages_omitted` and request details when the summary is not sufficient for the review.
  </Step>

  <Step title="Retrieve audio only when available">
    Check the record's audio availability before requesting a recording. A transcript does not imply that audio was recorded or retained.
  </Step>

  <Step title="Record the evidence">
    Keep the conversation, agent, branch, and version IDs with the issue you observed. Use that evidence to propose a prompt, knowledge, or tool change without sharing private transcripts publicly.
  </Step>
</Steps>

<Frame caption="Screenshot pending: An explicitly labeled synthetic conversation with transcript and version metadata.">
  <img src="https://mintcdn.com/threetonelabs-c2efc9c8/-FnvNeuT_PFanG1t/images/placeholders/screenshot-pending.svg?fit=max&auto=format&n=-FnvNeuT_PFanG1t&q=85&s=b29809bcbd6979cc43ace35853669b46" alt="Screenshot pending for An explicitly labeled synthetic conversation with transcript and version metadata. This illustration is not a product screenshot." width="1600" height="1000" className="w-full h-auto" loading="lazy" noZoom data-path="images/placeholders/screenshot-pending.svg" />
</Frame>

## Current analysis and search limits

Message text and semantic search currently have placeholder implementations. Agent topic results are also placeholders. Analysis and evaluation run routes currently read the existing conversation rather than perform new analysis. Do not rely on these routes to discover records or calculate review results.

Use filtered conversation lists and direct record reads for this workflow. Treat any `analysis` in a detail response as stored data, and inspect its provenance before using it to make decisions.

## Deletion and privacy

[Delete conversation](/api-reference/agents-platform/delete-conversation) is a distinct operation that should be used only for the intended record by an authorized caller. A deletion response or a saved retention setting is not a guarantee of deletion from backups or every connected service.

Automatic retention and zero-storage enforcement are not established by the documented implementation. Do not rely on those settings to meet your data-deletion requirements.

## Troubleshooting

If the list is empty, check filters, pagination, workspace access, and whether records actually exist. If details or audio are unavailable, check the identifier, permission, and recording status. See [API errors](/api-reference/errors) for request diagnostics and [versions and drafts](/agents-platform/deploy/versioning) for configuration traceability.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does every transcript have an audio recording?" id="faq-conversation-audio">No. Check audio availability and access before retrieving a recording.</Accordion>
  <Accordion title="Does a summary contain every message?" id="faq-summary-completeness">The summary has a message limit. Inspect messages\_omitted and read full details when needed.</Accordion>
  <Accordion title="Does an analysis run route compute new results?" id="faq-analysis-run">The documented route reads the existing conversation. Treat returned analysis as stored data and inspect its provenance.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.