Class ListClientsRequest.Builder
- Enclosing class:
ListClientsRequest
-
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 client by your ownexternalId.Name of the lookup field to filter by.from(ListClientsRequest other) Inclusive lower bound for a range lookup.Maximum number of clients to return per page (1–100; defaults to 20).order(ListClientsRequestOrder order) order(Optional<ListClientsRequestOrder> order) Sort direction for the results:asc(the default) ordesc.Return only clients belonging to this organization.Match clients whose value forfieldstarts with this prefix.Pagination cursor.Inclusive upper bound for a range lookup.Record type of the schema whose lookup fields you are querying.Return only clients owned by this user.Exact value to match forfield(equality mode).
-
Method Details
-
from
-
orgId
Return only clients belonging to this organization. Pass the Vectros-assigned UUID of an org; use
GET /v1/orgs?externalId=to resolve your own identifier to this UUID. -
orgId
-
userId
Return only clients owned by this user. Pass the Vectros-assigned UUID of a user; use
GET /v1/users?externalId=to resolve your own identifier to this UUID. -
userId
-
externalId
Look up a client by your own
externalId. Returns a single-element list, or an empty list if no client matches. -
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 clients to return per page (1–100; defaults to 20).
-
limit
-
type
Record type of the schema whose lookup fields you are querying. Must be supplied together with
fieldand exactly one lookup mode. -
type
-
field
Name of the lookup field to filter by. Must be declared as a lookup field on the schema identified by
type. Supply it together withtypeand exactly one lookup mode. -
field
-
value
Exact value to match for
field(equality mode). Mutually exclusive withfrom/toandprefix. Not allowed for a sensitive field — usePOST /v1/clients/lookupinstead so the value is not exposed in the URL. -
value
-
from
Inclusive lower bound for a range lookup. Requires
to, and is only allowed on non-sensitive fields that have range queries enabled. Mutually exclusive withvalueandprefix. -
from
-
to
Inclusive upper bound for a range lookup. Requires
from. -
to
-
prefix
Match clients whose value for
fieldstarts with this prefix. Only allowed on string fields that have range queries enabled. Mutually exclusive withvalueandfrom/to. -
prefix
-
order
Sort direction for the results:
asc(the default) ordesc. -
order
-
build
-
additionalProperty
-
additionalProperties
-