API Stability Long-Term

The pendingUsers() GraphQL query will return the pending users.

For more information on user authorization, see the Manage users & permissions documentation page.

Syntax

Below is the syntax for the pendingUsers() query field:

graphql
pendingUsers(
     search: string
   ): [PendingUser!]!

Given Datatypes

For the given datatype, PendingUser, there are several parameters that may be given. Below is a list of them along with their datatypes and a description of each:

Table: PendingUser

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For some fields, this column indicates that a result will always be returned for this column.
Table last updated: Mar 26, 2025
createdAtlongyes Long-TermThe time the pending user was created.
idstringyes Long-TermThe identifier or token for the pending user.
idpbooleanyes Long-TermWhether IdP is enabled for the organization.
invitedByEmailstringyes Long-TermThe email address of the user that invited the pending user.
invitedByNamestringyes Long-TermThe name of the user that invited the pending user.
newUserEmailstringyes Long-TermThe email of the pending user.
orgNamestringyes Long-TermThe name of the organization for the pending user.
pendingUserStatePendingUserStateyes Long-TermThe current organization state for the user. See PendingUserState.