# PhotoPrism Files API

**Canonical:** https://apis.io/apis/photoprism/photoprism-files-api/  
**Provider:** PhotoPrism — https://apis.io/providers/photoprism/  
**Base URL:** https://demo.photoprism.app  
**Documentation:** https://docs.photoprism.app/developer-guide/api/

PhotoPrism Files API is one of 32 APIs that [PhotoPrism](https://apis.io/providers/photoprism/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Files. The published artifact set on APIs.io includes an OpenAPI specification.

The Files API from PhotoPrism — 12 operation(s) for files.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/dl/{file}` | returns the raw file data |
| GET | `/api/v1/files/{hash}` | returns file details as JSON |
| GET | `/api/v1/files/{hash}/{name}` | streams the original file bytes for inline viewing (e.g. ".pdf" or ".svg") |
| POST | `/api/v1/markers` | Create api markers |
| PUT | `/api/v1/markers/{marker_uid}` | update a marker (face/subject region) |
| DELETE | `/api/v1/markers/{marker_uid}/subject` | clear the subject of a marker |
| GET | `/api/v1/photos/{uid}/dl` | returns the primary file matching that belongs to the photo |
| DELETE | `/api/v1/photos/{uid}/files/{fileuid}` | removes a file from storage |
| PUT | `/api/v1/photos/{uid}/files/{fileuid}/orientation` | changes the orientation of a file |
| GET | `/api/v1/t/{thumb}/{token}/{size}` | returns a thumbnail image with the requested size |
| POST | `/api/v1/users/{uid}/upload/{token}` | upload files to a user's upload folder |
| PUT | `/api/v1/users/{uid}/upload/{token}` | process previously uploaded files for a user |
| GET | `/api/v1/videos/{hash}/{token}/{format}` | returns a video, optionally limited to a byte range for streaming |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/photoprism/openapi/photoprism-files-api-openapi.yml

## Other PhotoPrism APIs (12)

- [PhotoPrism Albums API](https://apis.io/apis/photoprism/photoprism-albums-api/)
- [PhotoPrism Assets API](https://apis.io/apis/photoprism/photoprism-assets-api/)
- [PhotoPrism Authentication API](https://apis.io/apis/photoprism/photoprism-authentication-api/)
- [PhotoPrism Cameras API](https://apis.io/apis/photoprism/photoprism-cameras-api/)
- [PhotoPrism Cluster API](https://apis.io/apis/photoprism/photoprism-cluster-api/)
- [PhotoPrism Config API](https://apis.io/apis/photoprism/photoprism-config-api/)
- [PhotoPrism CORS API](https://apis.io/apis/photoprism/photoprism-cors-api/)
- [PhotoPrism Debug API](https://apis.io/apis/photoprism/photoprism-debug-api/)
- [PhotoPrism Download API](https://apis.io/apis/photoprism/photoprism-download-api/)
- [PhotoPrism Faces API](https://apis.io/apis/photoprism/photoprism-faces-api/)
- [PhotoPrism Folders API](https://apis.io/apis/photoprism/photoprism-folders-api/)
- [PhotoPrism Images API](https://apis.io/apis/photoprism/photoprism-images-api/)

## Tags

Files

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/photoprism/photoprism-files-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/photoprism/.