v41

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-011035599.5 KB
Authentication

🛡️ Log into a Cardinal app.

Logs the user into a client application that is hosted (bundled web app) or served by this server.

If logging into the Guest Account, no credentials are required. If logging into a Cardinal Account, a valid Cardinal SSO token is required.

The client app <strong>must</strong> set the <code>cardinal-app</code> header for this request.

Only the capability corresponding to the application that you are trying to log into will be validated.<br /><hr /><h3>🛡️ Requires one of these Capabilities: <code>AdminApp.Login</code> <code>MusicApp.Login</code> <code>PhotosApp.Login</code> <code>CinemaApp.Login</code></h3>

post/api/v1/auth/login

Headers

cardinal-app'admin' | 'music' | 'photos' | 'cinema'

Request body

userIdstring
usernamestring
passwordstring
cardinalJWTstring

Response

JWTstring required
userobject required
cloudJWTstring
cloudUserobject
refreshTokenstring
scopeobject