Me

Current User Query

Audience: Programmer

Returns the user profile of the currently authenticated user, including tenant associations and role assignments.

Arguments

This query does not take any arguments.

Return Type

UserProfile! - The user profile of the currently authenticated user.

Usage Example

query {
  me {
    UserID
    Username
    Email
    FirstName
    LastName
    TenantID
    TenantName
    # Recommended: Use Tenants for multi-tenant access
    Tenants {
      ID
      Name
      Role
    }
    # Deprecated: Use Tenants instead
    AssignedRoles {
      Role
      TenantID
    }
  }
}

Response Example

{
  "data": {
    "me": {
      "UserID": "550e8400-e29b-41d4-a716-446655440000",
      "Username": "john.doe",
      "Email": "[email protected]",
      "FirstName": "John",
      "LastName": "Doe",
      "TenantID": "123e4567-e89b-12d3-a456-426614174000",
      "TenantName": "Acme Corporation",
      "Tenants": [
        {
          "ID": "123e4567-e89b-12d3-a456-426614174000",
          "Name": "Acme Corporation",
          "Role": "admin"
        },
        {
          "ID": "987f6543-a21b-34c5-d678-123456789012",
          "Name": "Beta Industries",
          "Role": "viewer"
        }
      ]
    }
  }
}

Multi-Tenant Support

The me query now supports multi-tenant scenarios through the Tenants field:

• Primary Tenant: The TenantID and TenantName fields represent the user's primary tenant

• All Tenants: The Tenants array contains all accessible tenants with their respective roles

• Role Isolation: Each tenant association has its own role assignment

Field Deprecation

The AssignedRoles field is deprecated. Use the Tenants field instead:

# Old approach (deprecated)
query {
  me {
    AssignedRoles {
      Role
      TenantID
    }
  }
}

# New approach (recommended)
query {
  me {
    Tenants {
      ID
      Name
      Role
    }
  }
}

Common Use Cases

• Session Initialization: Retrieve user profile on application startup

• Tenant Selection: Display available tenants for user switching

• Authorization: Check user roles for the active tenant

• Profile Display: Show user information in the application header

• Audit Context: Capture user details for logging

Security Notes

• This query requires authentication

• Returns only the profile of the authenticated user

• Cannot be used to retrieve other users' profiles

• Tenant data is filtered based on user permissions