Skip to main content

​
Overview

When SCIM pending users is enabled, users provisioned via SCIM who have not logged in appear as pending in the Members and Groups pages. Pending users do not count toward workspace seats in billing.
This feature requires SCIM to be enabled for your workspace. Contact support@langdock.com to enable SCIM pending users.

​
What are Pending Users?

A user is considered pending when:
  • The user was provisioned via SCIM
  • The workspace has scimUsePendingUsers enabled
  • The user has never created a session in the workspace (never logged in)
Once a pending user logs in for the first time, they become an active user and count toward billing seats.

​
How It Works

​
User State Logic

The system determines user status by checking for existing sessions:
  • Active user: Has at least one session in the workspace
  • Pending user: Has zero sessions in the workspace
This check runs when:
  • Loading the Members page
  • Loading the Groups page
  • Calculating billing seat counts
  • Exporting user data to CSV

​
Billing Impact

When scimUsePendingUsers is enabled:
  • Only users with at least one session count toward Stripe subscription seats
  • Pending users are excluded from the seat count calculation
  • The workspace overview displays active user count separately from pending user count
Enabling this feature changes how seats are counted for billing. Review your current user list before enabling.

​
User Interface Changes

​
Members Page

The Members page displays pending users with:
  • A neutral user icon (instead of profile picture)
  • Email address as the title
  • “Pending since ” as the subtitle showing the provisioning date
  • Total count shows active users with “+N pending” appended
Example display: 
Members (45 +12 pending)

​
Groups Page

Group member lists show:
  • Pending status for users who haven’t logged in
  • “Pending since ” subtitle
  • Pending user count separate from active member count

​
CSV Export

When exporting users to CSV, the export includes a pending column if the feature is enabled. The column shows:
  • true for users with zero sessions
  • false for users who have logged in
CSV format with pending users enabled: 
email,name,role,joined,pending
user@example.com,User Name,member,2025-01-15T10:00:00Z,false
provisioned@example.com,,member,2025-01-20T14:30:00Z,true

​
Enabling the Feature

1

Verify SCIM is enabled

SCIM must be active for your workspace. Check workspace settings or contact support@langdock.com.
2

Contact Langdock support

Reach out to support@langdock.com to request enabling scimUsePendingUsers for your workspace.
3

Review provisioned users

After activation, review your Members page to see which users appear as pending.

​
Migration Notes

  • The feature is opt-in and defaults to false
  • Existing workspaces retain current behavior unless explicitly enabled
  • No data backfill required - the system checks session status in real-time
  • Users provisioned before enabling the feature will appear as pending if they haven’t logged in
  • The feature only affects SCIM-provisioned users

​
Technical Details

​
Database Schema

The feature adds the scim_use_pending_users boolean column to the workspace table:
  • Column name: scim_use_pending_users
  • Type: Boolean
  • Default: false
  • Database table: orgs

​
API Responses

When the feature is enabled, API responses include:
  • pending: Boolean field on user objects
  • pendingUsersCount: Count of users with zero sessions
  • totalCount: Count of active users (excludes pending)
  • createdAt: Timestamp of when the user was added to the workspace