---
title: "List attachments (metadata only)"
method: GET
path: "/api/attachments"
tags: ["Attachments"]
---

# List attachments (metadata only)

`GET /api/attachments`

## Request

- Base URL: `https://api.engram.page`
- URL: `https://api.engram.page/api/attachments`
- Auth: HTTP bearer

Returns metadata (path, MIME type, size, timestamps — no bytes) for every attachment in the current vault. Returns 500 if the listing fails.

## Response `200`

Attachments

- AttachmentsResponse
  - `attachments` AttachmentMeta[], required
    - `content_hash` string, nullable: Opaque content fingerprint. Stable for identical bytes and scoped to the owning account. Compare against a local copy to decide whether an upload is needed; re-uploading matching bytes is accepted but does no work.
    - `created_at` string, date-time, nullable
    - `id` string, uuid, nullable
    - `mime_type` string, nullable
    - `mtime` number, float: Client mtime (epoch seconds)
    - `path` string, required
    - `size_bytes` integer
    - `updated_at` string, date-time, nullable

## Other responses

- `500`: Listing failed

---

[API](https://skmtc.dev/engram/apis/engram-api.md) · [All operations](https://skmtc.dev/engram/apis/engram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/engram/apis/engram-api/revisions/8c4c2eec29dc?raw)