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

# read_conversations

> **Read conversations**

Read transcripts for specific tickets; read_table returns table rows. Results cover only the requested ids; the tool does not select a representative sample or calculate population counts. Up to 10 ids per call across `shortIds` and `externalIds`. The response flags truncation when size limits omit messages or conversations.

Each ticket is a `# conversation <id>` block, where `<id>` is the `external_id` when the ticket has one, else its `short_id`, followed by metadata lines and one `## <id>#<n>` header per message with body lines prefixed `<id>#<n> | `. `searchable_fields_omitted` names custom fields cut for size. A final `# not found` block lists unresolved ids with the reason.



## OpenAPI

````yaml /api-reference/tools-openapi.json post /v1/read_conversations
openapi: 3.1.0
info:
  title: Rippit API
  version: 1.0.0
  description: Every operation is also an MCP tool with the same name and parameters.
servers:
  - url: https://api.rippit.com
security:
  - bearer: []
paths:
  /v1/read_conversations:
    post:
      summary: read_conversations
      description: >-
        **Read conversations**


        Read transcripts for specific tickets; read_table returns table rows.
        Results cover only the requested ids; the tool does not select a
        representative sample or calculate population counts. Up to 10 ids per
        call across `shortIds` and `externalIds`. The response flags truncation
        when size limits omit messages or conversations.


        Each ticket is a `# conversation <id>` block, where `<id>` is the
        `external_id` when the ticket has one, else its `short_id`, followed by
        metadata lines and one `## <id>#<n>` header per message with body lines
        prefixed `<id>#<n> | `. `searchable_fields_omitted` names custom fields
        cut for size. A final `# not found` block lists unresolved ids with the
        reason.
      operationId: read_conversations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                shortIds:
                  description: >-
                    Rippit `ticket_sid` values from a table or tool result, not
                    worksheet row ids such as `__pkey`.
                  maxItems: 10
                  type: array
                  items:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                externalIds:
                  description: >-
                    Source-system ticket ids (an `external_id` column); a ticket
                    number the user names is usually one of these.
                  maxItems: 10
                  type: array
                  items:
                    type: string
                    minLength: 1
                bodyMode:
                  description: >-
                    Defaults to `stripped`: HTML and quoted email history
                    removed, each body capped at 10,000 characters. `full`
                    returns the stored body.
                  type: string
                  enum:
                    - stripped
                    - full
              additionalProperties: false
      responses:
        '200':
          description: Tool result.
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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