# PhotoPrism Albums API

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

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

The Albums API from PhotoPrism — 11 operation(s) for albums.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/albums` | finds albums and returns them as JSON |
| POST | `/api/v1/albums` | creates a new album |
| DELETE | `/api/v1/albums/{uid}` | deletes an existing album |
| GET | `/api/v1/albums/{uid}` | returns album details as JSON |
| PUT | `/api/v1/albums/{uid}` | updates album metadata like title and description |
| POST | `/api/v1/albums/{uid}/clone` | creates a new album containing pictures from other albums |
| GET | `/api/v1/albums/{uid}/dl` | streams the album contents as zip archive |
| DELETE | `/api/v1/albums/{uid}/like` | removes the favorite flag from an album |
| POST | `/api/v1/albums/{uid}/like` | sets the favorite flag for an album |
| GET | `/api/v1/albums/{uid}/links` | returns all share links for the given UID as JSON |
| POST | `/api/v1/albums/{uid}/links` | adds a new album share link and returns it as JSON |
| DELETE | `/api/v1/albums/{uid}/links/{linkuid}` | deletes an album share link |
| PUT | `/api/v1/albums/{uid}/links/{linkuid}` | updates an album share link and returns it as JSON |
| DELETE | `/api/v1/albums/{uid}/photos` | removes photos from an album |
| POST | `/api/v1/albums/{uid}/photos` | adds photos to an album |
| GET | `/api/v1/albums/{uid}/t/{token}/{size}` | returns an album cover image |
| POST | `/api/v1/batch/albums/delete` | permanently removes multiple albums |
| GET | `/api/v1/moments/time` | returns monthly albums as JSON |

## Machine-readable artifacts (2)

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

## Other PhotoPrism APIs (12)

- [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/)
- [PhotoPrism Images API](https://apis.io/apis/photoprism/photoprism-images-api/)

## Tags

Albums

---

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