Class ListUsersRequest.Builder
- Enclosing class:
ListUsersRequest
-
Method Summary
Modifier and TypeMethodDescriptionadditionalProperties(Map<String, Object> additionalProperties) additionalProperty(String key, Object value) build()externalId(String externalId) externalId(Optional<String> externalId) Look up a single user by your ownexternalId.The lookup field to filter on.from(ListUsersRequest other) Inclusive lower bound for a range lookup.Maximum number of users to return per page (1–100; defaults to 20).order(ListUsersRequestOrder order) order(Optional<ListUsersRequestOrder> order) Sort direction for the matched users:asc(ascending, the default) ordesc(descending).Prefix to match.Pagination cursor.Inclusive upper bound for a range lookup.The schema record type whose lookup fields you are querying (the schema's declared record type, not the user'sHUMAN/SERVICEkind).Exact value to match forfield.
-
Method Details
-
from
-
externalId
Look up a single user by your own
externalId. Returns a one-element list, or an empty list if no match. Cannot be combined with thetype/field/valuelookup parameters. -
externalId
-
startFrom
Pagination cursor. Pass the
nextCursorfrom the previous page to fetch the next page; omit it for the first page. -
startFrom
-
limit
Maximum number of users to return per page (1–100; defaults to 20).
-
limit
-
type
The schema record type whose lookup fields you are querying (the schema's declared record type, not the user's
HUMAN/SERVICEkind). Must be supplied together withfieldand exactly one lookup mode (value,from+to, orprefix). -
type
-
field
The lookup field to filter on. Must be declared as a lookup field on the schema named by
type. Supplied together withtypeand one lookup mode. -
field
-
value
Exact value to match for
field. Cannot be combined withfrom/toorprefix. Not allowed for a sensitive (blind-indexed) field on this endpoint; use POST /v1/users/lookup instead, which keeps the value out of the URL. -
value
-
from
Inclusive lower bound for a range lookup. Requires
to, and is only valid on non-sensitive fields declared with range support. Cannot be combined withvalueorprefix. -
from
-
to
Inclusive upper bound for a range lookup. Requires
from. -
to
-
prefix
Prefix to match. Only valid on string fields declared with range support. Cannot be combined with
valueorfrom/to. -
prefix
-
order
Sort direction for the matched users:
asc(ascending, the default) ordesc(descending). -
order
-
build
-
additionalProperty
-
additionalProperties
-