Session Resume Manager - API Contract

GET /api/v1/session-resume/api/v1/session-resume

Public

Response Example

{
  "data": [
    {
      "id": "resume_001",
      "user_id": "usr_9a2f31",
      "event_type": "app_resumed",
      "biometric_prompted": true,
      "biometric_result": "success",
      "resumed_at": "2026-03-26T07:55:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 12
  }
}

GET /api/v1/session-resume/api/v1/session-resume/:id

Public

Response Example

{
  "id": "resume_001",
  "user_id": "usr_9a2f31",
  "event_type": "app_resumed",
  "biometric_prompted": true,
  "biometric_result": "success",
  "resumed_at": "2026-03-26T07:55:00Z"
}

POST /api/v1/session-resume/api/v1/session-resume/initialize

Public

Request Example

{
  "user_id": "usr_9a2f31",
  "session_id": "sess_7d3k99",
  "biometric_required": true
}

Response Example

{
  "id": "resume_002",
  "user_id": "usr_9a2f31",
  "session_id": "sess_7d3k99",
  "initialized": true,
  "biometric_required": true,
  "created_at": "2026-03-26T09:05:00Z"
}

POST /api/v1/session-resume/api/v1/session-resume/app-resumed

Public

Request Example

{
  "user_id": "usr_9a2f31",
  "session_id": "sess_7d3k99",
  "resumed_at": "2026-03-26T09:10:00Z"
}

Response Example

{
  "should_prompt_biometric": true,
  "session_still_valid": true,
  "message": "Biometric re-authentication required after background timeout"
}

GET /api/v1/session-resume/api/v1/session-resume/should-prompt

Public

Response Example

{
  "should_prompt": true,
  "reason": "session_idle_timeout",
  "idle_duration_seconds": 310
}

PUT /api/v1/session-resume/api/v1/session-resume/:id

Public

Request Example

{
  "biometric_result": "success"
}

Response Example

{
  "id": "resume_001",
  "user_id": "usr_9a2f31",
  "biometric_prompted": true,
  "biometric_result": "success",
  "resumed_at": "2026-03-26T07:55:00Z"
}

DELETE /api/v1/session-resume/api/v1/session-resume

Public

Response Example

{
  "disposed": true,
  "message": "Session resume manager disposed"
}

DELETE /api/v1/session-resume/api/v1/session-resume/:id

Public

Response Example

{
  "deleted": true,
  "id": "resume_001"
}

Additional Metadata

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