Tenant Session Store

List active tenant sessions for the current user

{
  "data": [
    {
      "session_id": "ses_01J4K8M2N3P5Q7S1",
      "user_id": "usr_01J4K8M2N3P5Q7A1",
      "org_id": "org_01J4K8M2N3P5Q7R9",
      "org_name": "Northbrook Academy",
      "is_active": true,
      "created_at": "2026-03-26T09:00:00Z",
      "expires_at": "2026-03-27T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Get a specific tenant session with full context payload

{
  "session_id": "ses_01J4K8M2N3P5Q7S1",
  "user_id": "usr_01J4K8M2N3P5Q7A1",
  "org_id": "org_01J4K8M2N3P5Q7R9",
  "org_name": "Northbrook Academy",
  "tenant_context": {
    "org_id": "org_01J4K8M2N3P5Q7R9",
    "role": "admin",
    "terminology": {
      "student": "Learner",
      "class": "Cohort"
    },
    "feature_flags": {
      "peer_review_beta": true,
      "analytics_dashboard": false
    }
  },
  "is_active": true,
  "created_at": "2026-03-26T09:00:00Z",
  "expires_at": "2026-03-27T09:00:00Z"
}

Create and persist a new tenant session for the selected org

{
  "org_id": "org_01J4K8M2N3P5Q7R9",
  "tenant_context": {
    "org_id": "org_01J4K8M2N3P5Q7R9",
    "role": "admin",
    "terminology": {
      "student": "Learner"
    },
    "feature_flags": {
      "peer_review_beta": true
    }
  }
}

{
  "session_id": "ses_01J9X3P7K2M4N6G6",
  "user_id": "usr_01J4K8M2N3P5Q7A1",
  "org_id": "org_01J4K8M2N3P5Q7R9",
  "org_name": "Northbrook Academy",
  "is_active": true,
  "created_at": "2026-03-26T12:00:00Z",
  "expires_at": "2026-03-27T12:00:00Z"
}

Refresh or update the tenant context within an existing session

{
  "tenant_context": {
    "org_id": "org_01J4K8M2N3P5Q7R9",
    "role": "admin",
    "terminology": {
      "student": "Learner",
      "class": "Cohort"
    },
    "feature_flags": {
      "peer_review_beta": true,
      "ai_feedback_assistant": true
    }
  }
}

{
  "session_id": "ses_01J9X3P7K2M4N6G6",
  "user_id": "usr_01J4K8M2N3P5Q7A1",
  "org_id": "org_01J4K8M2N3P5Q7R9",
  "is_active": true,
  "updated_at": "2026-03-26T14:00:00Z",
  "expires_at": "2026-03-27T14:00:00Z"
}

Terminate and clear a specific tenant session

{
  "success": true,
  "cleared_at": "2026-03-26T16:00:00Z"
}

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