v52

latestOpenAPI 3.0.4GPL-3.0raw.githubusercontent.com2026-08-03509370876.8 KB
Plugin

Authenticate with the Server given an auth key. This will log you in by returning the user object and the JWT token.

This API is not fully built out and may require more information in later releases

post/api/Plugin/authenticate

Query parameters

apiKeystring required

Auth key which will be used to authenticate and return a valid user token back

pluginNamestring required

Name of the Plugin

Response

OK

idinteger
oidcIdstring nullable
usernamestring nullable
emailstring nullable
rolesstring[] nullable
tokenstring nullable
refreshTokenstring nullable
apiKeystring nullable
kavitaVersionstring nullable
identityProvider0 | 1

Members:

  • 0 — Kavita
  • 1 — OpenID Connect (OpenIdConnect)
createdstring date-time
createdUtcstring date-time
coverImagestring nullable
primaryColorstring nullable
secondaryColorstring nullable