> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmateo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sending Attachments

> Learn how to send attachments

All messaging endpoints support sending attachments. You can include either one or multiple attachments in one of two formats:

1. **HTTPS URL**: We'll download the attachment from the provided URL. This is the easiest method, but requires you to serve your files over the internet.

2. **Media Library URI**: Use this feature when you need to upload files directly using the `media_library://` protocol.

## Using the Media Library

First, create a signed upload URL with the path to your file:

```ts theme={null}
const response = await api.request(
  `/storage/upload/sign/media_library/test.png`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
  }
);

const url = await response.text();
```

The file will be uploaded to `test.png`.

You can also upload to nested paths, for example `/storage/upload/sign/media_library/my-dir/test.png`. This will create an upload URL for `my-dir/test.png`.

Next, upload your file using the signed URL:

```ts theme={null}
const res = await fetch(url, {
  method: 'PUT',
  body: Buffer.from(BASE_64_IMAGE, 'base64'),
  headers: { 'Content-Type': 'image/png' },
});
```

Media library files are automatically deleted after 30 days. Until then, you can use them as often as needed when sending messages or broadcasts by passing them as attachments:

* `attachments: ["media_library://test.png"]`
* `attachments: ["media_library://my-dir/test.png"]`