List conversation attachments

Base URL: https://{kibana_url}

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

Auth

List all attachments for a conversation. Use the optional include_deleted query parameter to include soft-deleted attachments.

Required authorization

Privileges agentBuilder:read

Path parameters

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.
conversation_id string · max length: 256 required: The unique identifier of the conversation.

Query parameters

include_deleted boolean: Whether to include deleted attachments in the list.

Response

200

Indicates a successful response

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

GET kbn:/api/agent_builder/conversations/CONVERSATION_ID/attachments

Generated from the API spec

curl Shell

curl -X GET "${KIBANA_URL}/api/agent_builder/conversations/${CONVERSATION_ID}/attachments" \
  -H "Authorization: ApiKey ${API_KEY}"

Generated from the API spec

Response

Example response containing active attachments for a conversation

{
  "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
}