# Feature OP-10114 - APIv3 attachments index

Project: OpenProject
Status: specified
URL: https://community.openproject.org/work_packages/OP-10114

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | Wish List |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers |  |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As** an OpenProject APIv3 user  
**I want to** be able to list all attachments  
**so that** I can get an overview over all uploaded files and their metadata.

**Acceptance criteria**

*   add new endpoint `GET /api/v3/attachments`
*   include metadata (file name, file size, created at, updated at, content type) for each attachment
*   include download link for each attachment
*   support for `filters`, `sortBy` parameters
*   show `totalSize` in MB next to `total` (number of attachments) in collection

**Discussion**

This would allow users to make incremental backups of their uploaded files by querying this endpoint for all attachments added after the last check using the respective filter.

This would also allow them to make a complete backup of all their attachments without putting too much load on the servers in the Cloud Edition (other than the requests to generate the download links).
