---
type: api
title: List conversation attachments
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-get-agent-builder-conversations-conversation-id-attachments
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-get-agent-builder-conversations-conversation-id-attachments
products:
  - Kibana
---

# List conversation attachments

Availability: 9.2+

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/agent_builder/conversations/{conversation_id}/attachments`
- `GET` `/s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v9/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v9/authentication#basicauth)

#### Path Parameters

- `conversation_id` (string)
  The unique identifier of the conversation.

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

List all attachments for a conversation. Use the optional include_deleted query parameter to include soft-deleted attachments.<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.

## Query String Parameters

- `include_deleted` (boolean)
  Whether to include deleted attachments in the list.

## Response

Indicates a successful response

## Code Examples

#### Console

```console
GET /api/agent_builder/conversations/{conversation_id}/attachments
```

#### curl

```curl
curl -X GET "https://{kibana_url}/api/agent_builder/conversations/{conversation_id}/attachments"
```

## Response Examples

#### List attachments response

Example response containing active attachments for a conversation

```json
{
  "results": [
    {
      "active": true,
      "current_version": 2,
      "description": "My text file",
      "id": "attachment-1",
      "type": "text",
      "versions": [
        {
          "content_hash": "abc123",
          "created_at": "2025-01-01T10:00:00.000Z",
          "data": "Initial content",
          "estimated_tokens": 3,
          "version": 1
        },
        {
          "content_hash": "def456",
          "created_at": "2025-01-01T11:00:00.000Z",
          "data": "Updated content",
          "estimated_tokens": 3,
          "version": 2
        }
      ]
    },
    {
      "active": true,
      "current_version": 1,
      "description": "Configuration data",
      "id": "attachment-2",
      "type": "json",
      "versions": [
        {
          "content_hash": "ghi789",
          "created_at": "2025-01-01T12:00:00.000Z",
          "data": {
            "key": "value",
            "nested": {
              "field": 123
            }
          },
          "estimated_tokens": 15,
          "version": 1
        }
      ]
    }
  ],
  "total_token_estimate": 21
}
```