Search user / group subjects within the caller's contact scope

GET 
/api/v1/directory/subjects

Ranked search over users/groups the caller may see (ADR-0048 §2.4).

• search is required and must be at least two characters to prevent directory enumeration.
• Non-admin callers only see subjects in their contact scope; admins see all subjects.
• Ranking: exact id → prefix (display_name/alias/email) → substring, ties broken alphabetically by display_name.
• next_cursor is reserved for future pagination and is always null today.

Request

Responses

200

Successful Response

422

Validation Error