# PhotoPrism Authentication API

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

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

The Authentication API from PhotoPrism — 18 operation(s) for authentication.

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/oauth/authorize` | OAuth2 authorization endpoint for apps (authorization code flow with PKCE) |
| POST | `/api/v1/oauth/consent` | returns a pending OAuth authorization request for the consent page |
| POST | `/api/v1/oauth/consent/approve` | approves a pending OAuth authorization request |
| POST | `/api/v1/oauth/consent/deny` | denies a pending OAuth authorization request |
| GET | `/api/v1/oauth/logout` | OAuth2/OIDC end-session endpoint (RP-initiated logout) |
| POST | `/api/v1/oauth/logout` | OAuth2/OIDC end-session endpoint (RP-initiated logout) |
| POST | `/api/v1/oauth/revoke` | revoke an OAuth2 access token or session |
| POST | `/api/v1/oauth/token` | create an OAuth2 access token |
| GET | `/api/v1/oauth/userinfo` | OAuth2/OIDC userinfo endpoint |
| POST | `/api/v1/oauth/userinfo` | OAuth2/OIDC userinfo endpoint |
| GET | `/api/v1/oidc/login` | start OpenID Connect login (browser redirect) |
| GET | `/api/v1/oidc/redirect` | complete OIDC login (callback) |
| DELETE | `/api/v1/session` | delete a session (logout) |
| GET | `/api/v1/session` | get the current session or a session by id |
| POST | `/api/v1/session` | create a session (login) |
| DELETE | `/api/v1/session/{id}` | delete a session (logout) |
| GET | `/api/v1/session/{id}` | get the current session or a session by id |
| POST | `/api/v1/sessions` | create a session (login) |
| DELETE | `/api/v1/sessions/{id}` | delete a session (logout) |
| GET | `/api/v1/sessions/{id}` | get the current session or a session by id |
| GET | `/api/v1/users/{uid}/grants` | list the apps connected to a user account |
| DELETE | `/api/v1/users/{uid}/grants/{grant}` | disconnect an app from a user account |
| PUT | `/api/v1/users/{uid}/password` | change a user's password |
| GET | `/api/v1/users/{uid}/sessions` | list sessions for a user |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/photoprism/openapi/photoprism-authentication-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 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

Authentication

---

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