Authentication
Sign-in, token refresh, password reset, SSO completion – and API access with API keys.
This group covers user sign-in: login with email address or username and password, renewing the session with a refresh token, resetting a forgotten password, and completing a single sign-on login (SAML/OIDC). The endpoints return an access token (JWT), which is sent in the `Authorization: Bearer <token>` header, and a refresh token that is replaced by a new one each time it is used.
For machine access to your data from your own applications, use an API key for the REST API at `https://zentor-app.de/api/v1` instead of a user login. Zentor enables API access on request; administrators then create keys with defined permissions (scopes) in the dashboard under “API keys”. The key is sent in the `Authorization: Bearer <API key>` header or in the `X-API-Key` header. Scopes, error codes and advice on storing keys securely are described in the API reference overview.
The sign-in endpoints are protected against repeated failed attempts: after several incorrect entries, the server delays further attempts and temporarily blocks them with 429 `RATE_LIMIT_EXCEEDED`.