Search users | Distru Documentation

Searches Distru users — the caller's teammates within their company, e.g. to find who owns an order or a task.

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
limit	integer	No	Default: `10`
cursor	string	No	nextCursor of the previous call; keep the other arguments unchanged.
ids	string[]	No
search	string	No	Case-insensitive substring of full name. Ranked by similarity; sortBy ignored.
ownerAssignableEntityType	enum `ASSEMBLYBATCHCREDITINVOICEMENUORDERPRODUCTPURCHASE`	No	Only users the caller may assign as owner of this entity type, per team visibility. ORDER = sales order.
sortBy	object	No	Default UPDATED_AT DESC. Ignored when search is set.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `FULL_NAMEINSERTED_ATUPDATED_AT`	Yes

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence
hasMore	boolean	Always
nextCursor	string	Can be absent
totalCount	integer	Can be absent
items	object[]	Always
items[].id	string	Always
items[].email	string	Always
items[].profile	object	Always
items[].profile.fullName	string	Always
items[].profile.firstName	string	Always
items[].profile.lastName	string	Can be null
items[].profile.initials	string	Always

What the AI reads

Searches Distru users — the caller's teammates within their company, e.g. to find who owns an order or a task. For the caller themself, use distru-get-me.