Skip to content

Reference

Every environment serves these on its own issuer host, such as https://your-app.auth.dev.seek.services. The management API has a section of its own.

Page What it covers
Discovery and keys The OpenID Connect discovery document of an environment, every field it carries, and the JSON Web Key Set that access and ID tokens are verified with.
/authorize The authorization endpoint - every query parameter, the PKCE and redirect URI rules, the code it returns, how errors come back, single sign-on, prompt, max_age and acr_values.
Embedded login (/authorize-challenge) The endpoint the embedded login runs on - the request envelope, every step and challenge, rejections, errors, the hosted page’s variant and the login UI’s configuration.
/token The token endpoint - client authentication, DPoP, the authorization code, refresh token and client credentials grants, the response, resource and audience rules, and its errors.
/userinfo The UserInfo endpoint - how to authenticate with a Bearer or DPoP access token, the claims each scope gives, and its errors.
Revocation and introspection The revocation endpoint (RFC 7009), which ends a refresh token and, for an embedded login, its session; and the introspection endpoint (RFC 7662) for confidential clients.
/logout RP-initiated logout - the parameters, when the user is asked to confirm, which return addresses are followed, and what ends.
Session tickets How a login is carried to another app of the same group - minting a one-time ticket at /session-ticket and redeeming it at /authorize.
Tokens and claims What access tokens, ID tokens and refresh tokens carry - headers, every claim for users and machine clients, how roles and permissions are computed, the scopes, and the acr and amr values.
Account API The API a signed-in user calls to manage their own account - profile, password, email address, authenticator app, recovery codes, passkeys, linked providers, sessions and deleting the account.
Lifetimes How long tokens and sessions last - the six lifetimes an environment sets, their defaults and limits, how a change reaches existing sessions, and the lifetimes that are fixed.
Errors The two error shapes SeekAuth answers with - { code, message } from the management and account APIs, and the OAuth shape from the protocol endpoints - with every code, its status and its headers.
Rate limits Every rate limit SeekAuth applies to logins, code emails, the account API and the management API, what an answer over a limit looks like, and when a captcha is asked instead.