---
type: api
title: Get stream attachments
description: Fetches all attachments linked to a stream that are visible to the current user in the current space. Optionally filter by attachment types, search query, and tags.<br/><br/>[Required authorization] Route required privileges: read_stream.
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v0/operation/operation-get-streams-streamname-attachments
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v0/operation/operation-get-streams-streamname-attachments
products:
  - Kibana
---

# Get stream attachments

Availability: Experimental since 9.3

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

## Paths

- `GET` `/api/streams/{streamName}/attachments`

#### Path parameters

- `streamName` (string · max length: 200) — required
  The name of the stream

## Description

Fetches all attachments linked to a stream that are visible to the current user in the current space. Optionally filter by attachment types, search query, and tags.

## Required authorization

- Privileges: `read_stream`

## Authentication

- Api key: `Authorization: <value>`
  These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: `Authorization: ApiKey base64AccessApiKey`
- Basic: `Authorization: Basic <credentials>`

## Query string parameters

- `query` (string · max length: 1000) — optional
  Search query to filter attachments by title
- `attachmentTypes` (enum[] · max items: 3) — optional
  Filter by attachment types (single value or array)
  Values: `dashboard`, `rule`, `slo`
- `tags` (string[] · max items: 100) — optional
  Filter by tags (single value or array)

## Request body

`application/json`

Any of:
- **object**
- **object**

## Response

Successfully retrieved attachments

`application/json`

## Code examples

#### Console

```console
GET kbn:/api/streams/STREAM_NAME/attachments
{}
```

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/streams/${STREAM_NAME}/attachments" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response examples

#### List attachments

```json
{
  "attachments": [
    {
      "createdAt": "2023-02-23T16:15:47.275Z",
      "description": "Dashboard for monitoring production services",
      "id": "dashboard-123",
      "streamNames": [
        "logs.awsfirehose",
        "logs.nginx"
      ],
      "tags": [
        "monitoring",
        "production"
      ],
      "title": "My Dashboard",
      "type": "dashboard",
      "updatedAt": "2023-03-24T14:39:17.636Z"
    }
  ]
}
```