List conversation attachments Technical Preview

GET /api/agent_builder/conversations/{conversation_id}/attachments
Api key auth

Spaces method and path for this operation:

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

Refer to Spaces for more information.

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

[Required authorization] Route required privileges: read_agent_builder.

Path parameters

  • conversation_id string Required

    The unique identifier of the conversation.

Query parameters

  • include_deleted boolean

    Whether to include deleted attachments in the list.

Responses

  • 200 application/json

    Indicates a successful response

GET /api/agent_builder/conversations/{conversation_id}/attachments 
curl \
 --request GET 'https://<KIBANA_URL>/api/agent_builder/conversations/{conversation_id}/attachments' \
 --header "Authorization: $API_KEY"
Response examples (200)
Example response containing active attachments for a conversation 
{
  "results": [
    {
      "id": "attachment-1",
      "type": "text",
      "active": true,
      "versions": [
        {
          "data": "Initial content",
          "version": 1,
          "created_at": "2025-01-01T10:00:00.000Z",
          "content_hash": "abc123",
          "estimated_tokens": 3
        },
        {
          "data": "Updated content",
          "version": 2,
          "created_at": "2025-01-01T11:00:00.000Z",
          "content_hash": "def456",
          "estimated_tokens": 3
        }
      ],
      "description": "My text file",
      "current_version": 2
    },
    {
      "id": "attachment-2",
      "type": "json",
      "active": true,
      "versions": [
        {
          "data": {
            "key": "value",
            "nested": {
              "field": 123
            }
          },
          "version": 1,
          "created_at": "2025-01-01T12:00:00.000Z",
          "content_hash": "ghi789",
          "estimated_tokens": 15
        }
      ],
      "description": "Configuration data",
      "current_version": 1
    }
  ],
  "total_token_estimate": 21
}