Get Authentication Status

GET 
/api/auth/status

Get detailed information about the current status authentication status of the user.

This endpoint is primarily designed for cookie-based authentication. Singularity sets HTTP-only cookies by default which cannot be accessed via JavaScript. Therefore, you can use this endpoint to request if valid tokens are set.

Responses

200

The current user's authentication status.

401

The following error codes correspond to this status:

• ACCESS_TOKEN_EXPIRED: Indicates that the access token is expired.
• ACCESS_TOKEN_INVALID: Indicates that the access token cannot be decoded.

404

The following error codes correspond to this status:

• PRINCIPAL_NOT_FOUND: No principal with specified ID found.

500

The following error codes correspond to this status:

• ACCESS_TOKEN_ALLOWLIST_READING_FAILURE: Represents an exception indicating a failure when reading the allowlist for an access token cache.
• DATABASE_FAILURE: Exception representing a general failure related to database operations.
• DATABASE_ENCRYPTION_FAILURE: Exception representing a general failure related to database encryption operations.
• INVALID_PRINCIPAL_DOCUMENT: A requested principal document was stored in an invalid format.