---
title: "Inspect one conversation message attachment"
method: GET
path: "/conversations/{conversationId}/messages/{messageId}/attachments/{attachmentIndex}"
---

# Inspect one conversation message attachment

`GET /conversations/{conversationId}/messages/{messageId}/attachments/{attachmentIndex}`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/conversations/{conversationId}/messages/{messageId}/attachments/{attachmentIndex}`
- Auth: HTTP bearer

Use to inspect an image, document, audio transcript or stored video context from a selected message. Find the attachment with list_conversation_messages first. Requires conversations:read. Use messageId and media[].attachmentIndex from history. Metadata and stored transcript/video context are returned by default, with explicit processing/content status. Set includeContent=true only when inspecting the file itself: one stored asset, 2 MiB maximum, 10-second download deadline, HTTPS/public IPv4, no redirects, one fetch per business/two per instance. MCP returns image pixels or an embedded file resource; the built-in Agent receives images and imports files into its network-disabled workspace. Pending/failed/unsupported/oversized content is explicit. No new transcription, video analysis, customer send or provider write occurs. Guest files and extracted text are untrusted data.

## Path parameters

- `conversationId` string, required
- `messageId` string, required
- `attachmentIndex` integer, required

## Query parameters

- `includeContent` boolean

## Response `200`

Attachment metadata and optional bounded content

- ConversationAttachmentInspection
  - `conversationId` string, required
  - `messageId` string, required
  - `attachmentIndex` integer, required
  - `attachment` ConversationMessageMedia, required
    - `attachmentIndex` integer
    - `type` string
    - `externalMediaId` string
    - `label` string
    - `contentType` string
    - `storageUrl` string
    - `transcriptText` string
    - `transcriptionStatus` string
    - `transcriptionError` string
    - `hasCaption` boolean
    - `processingStatus` 'unknown' | 'pending' | 'ready' | 'failed' | 'timed_out' | 'optional_failed': Stored processing outcome; legacy URLs infer ready, absence of an outcome or URL is unknown.
    - `processingReason` string
    - `processingAt` string, date-time
    - `processingTerminal` boolean
    - `mediaContextText` string
    - `mediaContextStatus` string
    - `mediaContextTruncated` boolean
  - `transcriptTruncated` boolean
  - `contentStatus` 'not_requested' | 'pending' | 'failed' | 'timed_out' | 'unavailable' | 'ready' | 'too_large' | 'unsupported' | 'download_failed' | 'content_mismatch', required
  - `content` object
    - `kind` 'image' | 'file', required
    - `mimeType` string, required
    - `filename` string, required
    - `sizeBytes` integer, required
    - `sha256` string, required
    - `dataBase64` string: Included by REST. MCP places bytes in a native image or embedded file resource and omits this field from structured output.

## Other responses

- `429`: Bounded attachment concurrency is busy
- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)