Password login
Authenticate with a role password and issue a session.
Failed attempts are rate-limited per source IP. Sustained failures across all sources may trigger a temporary global cooldown.
Cookie mode (token_usage=cookie): returns HTTP 204 and sets an
HTTP-only ouster_session cookie (Path=/, SameSite=Strict;
Secure when the request arrived over HTTPS).
Bearer mode (token_usage=bearer): returns HTTP 200 with a
session JWT in the body.
Request
This endpoint expects an object.
role
Allowed values:
password
token_usage
cookie — session delivered via HTTP-only ouster_session cookie (browser clients).
bearer — session JWT returned in the response body (API clients).
Allowed values:
Response
Login successful (bearer mode)
token
HS256 session JWT for Authorization Bearer use
role
Allowed values:
exp_poh
Session expiration
Errors
400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error

