---
title: document_list
description: List the files attached to a brand, each with a URL you can fetch.
---

Lists the **documents** attached to a brand — logo, guidelines, decks — each with a URL you can fetch directly.

Uploads that were reserved but never completed are **not** listed: there is no file behind them, so every URL returned here resolves.

## Input

| Field        | Type     | Required | Description                         |
| ------------ | -------- | -------- | ----------------------------------- |
| `brand_name` | `string` | yes      | The brand slug whose files to list. |

## Output

An array of `{ id, name, filename, mimeType, sizeBytes, url }`, newest first.

## Example

> _"What brand materials do we have for Acme?"_

```ts
document_list({ brand_name: 'acme-running' });
// → [{ name: 'brand-guidelines.pdf', mimeType: 'application/pdf',
//      url: 'https://documents.adcrunch.dev/org_…/doc_…' }]
```

The same list is included in [`brand_get`](/mcp/tools/brand-get), so if you're already loading the brand's context you don't need a second call.

Requires the `brand:read` scope.