Skip to main content

Purpose

Returns all team members and pending invitations for an organization. Uses caching to reduce Clerk API calls.

Architecture

Query Parameters

ParameterTypeDefaultDescription
limitint100Max members to return
offsetint0Pagination offset
include_pendingbooltrueInclude pending invitations
force_refreshboolfalseBypass cache

Response Format

{
  "organization_id": "org_abc123",
  "members": [
    {
      "membership_id": "mem_...",
      "user_id": "user_...",
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "image_url": "https://...",
      "role": "org:admin",
      "created_at": 1702234567
    }
  ],
  "pending_invitations": [...],
  "total_members": 5,
  "from_cache": false
}

Code Location

src/app/apis/settings_team/members/routes.py