Auth Session Manager - API Contract

GET /api/v1/auth/sessions/api/v1/auth/sessions

List active sessions for current user

Public

Response Example

{
  "data": [
    {
      "session_id": "sess_a1b2c3d4",
      "user_id": "usr_7f3a1c9d",
      "provider": "vipps",
      "access_token": "eyJhbGciOiJSUzI1NiJ9...",
      "expires_at": "2026-03-26T22:00:00Z",
      "created_at": "2026-03-26T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

GET /api/v1/auth/sessions/api/v1/auth/sessions/current

Get the current authenticated session

Public

Response Example

{
  "session_id": "sess_a1b2c3d4",
  "user_id": "usr_7f3a1c9d",
  "provider": "vipps",
  "access_token": "eyJhbGciOiJSUzI1NiJ9...",
  "refresh_token": "rt_xKpQwErTyUiOpAsDfGh",
  "expires_at": "2026-03-26T22:00:00Z",
  "created_at": "2026-03-26T10:00:00Z"
}

POST /api/v1/auth/sessions/api/v1/auth/sessions/refresh

Refresh the current session using refresh token

Public

Request Example

{
  "refresh_token": "rt_xKpQwErTyUiOpAsDfGh"
}

Response Example

{
  "session_id": "sess_a1b2c3d4",
  "user_id": "usr_7f3a1c9d",
  "access_token": "eyJhbGciOiJSUzI1NiJ9.newtoken...",
  "refresh_token": "rt_newRefreshToken123",
  "expires_at": "2026-03-27T10:15:00Z",
  "refreshed_at": "2026-03-26T10:15:00Z"
}

DELETE /api/v1/auth/sessions/api/v1/auth/sessions/current

Sign out and invalidate current session

Public

Response Example

{
  "signed_out": true,
  "signed_out_at": "2026-03-26T10:20:00Z"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}