# PhotoPrism Photos API

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

PhotoPrism Photos 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 Photos. The published artifact set on APIs.io includes an OpenAPI specification.

The Photos API from PhotoPrism — 17 operation(s) for photos.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/batch/photos/approve` | approves multiple photos that are currently under review |
| POST | `/api/v1/batch/photos/archive` | moves multiple photos to the archive |
| POST | `/api/v1/batch/photos/delete` | permanently removes multiple or all photos from the archive |
| POST | `/api/v1/batch/photos/edit` | returns and updates the metadata of multiple photos |
| POST | `/api/v1/batch/photos/private` | toggles private state of multiple photos |
| POST | `/api/v1/batch/photos/restore` | restores multiple photos from the archive |
| GET | `/api/v1/geo` | finds photos and returns results as JSON, so they can be displayed on a map or… |
| GET | `/api/v1/photos` | finds pictures and returns them as JSON |
| GET | `/api/v1/photos/view` | finds pictures and returns a viewer-formatted JSON result for the lightbox |
| GET | `/api/v1/photos/{uid}` | returns picture details as JSON |
| PUT | `/api/v1/photos/{uid}` | updates picture details and returns them as JSON |
| POST | `/api/v1/photos/{uid}/approve` | marks a photo in review as approved |
| POST | `/api/v1/photos/{uid}/files/{fileuid}/primary` | sets the primary file for a photo |
| POST | `/api/v1/photos/{uid}/files/{fileuid}/unstack` | removes a file from an existing photo stack |
| POST | `/api/v1/photos/{uid}/label` | adds a label to a photo |
| DELETE | `/api/v1/photos/{uid}/label/{id}` | removes a label from a photo |
| PUT | `/api/v1/photos/{uid}/label/{id}` | changes a photo label |
| DELETE | `/api/v1/photos/{uid}/like` | removes the favorite flags from a photo |
| POST | `/api/v1/photos/{uid}/like` | flags a photo as favorite |
| GET | `/api/v1/photos/{uid}/yaml` | returns picture details as YAML |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/photoprism/openapi/photoprism-photos-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 Files API](https://apis.io/apis/photoprism/photoprism-files-api/)
- [PhotoPrism Folders API](https://apis.io/apis/photoprism/photoprism-folders-api/)

## Tags

Photos

---

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