Role State Manager

List active role sessions

{
  "data": [
    {
      "session_id": "sess_c1d2e3f4",
      "user_id": "usr_8f3a1b2c",
      "current_role": "coordinator",
      "previous_role": "mentor",
      "switched_at": "2026-03-26T08:30:00Z",
      "is_active": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 12
  }
}

Get current role state for a session

{
  "session_id": "sess_c1d2e3f4",
  "user_id": "usr_8f3a1b2c",
  "current_role": "coordinator",
  "previous_role": "mentor",
  "switched_at": "2026-03-26T08:30:00Z",
  "is_active": true
}

Initialize a role session for a user

{
  "user_id": "usr_8f3a1b2c",
  "initial_role": "mentor"
}

{
  "session_id": "sess_c1d2e3f4",
  "user_id": "usr_8f3a1b2c",
  "current_role": "mentor",
  "previous_role": null,
  "switched_at": "2026-03-26T10:20:00Z",
  "is_active": true
}

Switch active role within an existing session

{
  "new_role": "coordinator",
  "reset_state": false
}

{
  "session_id": "sess_c1d2e3f4",
  "user_id": "usr_8f3a1b2c",
  "current_role": "coordinator",
  "previous_role": "mentor",
  "switched_at": "2026-03-26T10:25:00Z",
  "is_active": true
}

Reset and terminate a role session

{
  "deleted": true,
  "session_id": "sess_c1d2e3f4"
}

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