List users (for assignment pickers and member management)

GET 
/api/users

List users (for assignment pickers and member management). Pass ?email=<exact-match> to look up a single user by email — used by the MCP / pt CLI assignee resolver to translate the INF-125 agent-claim convention email (agent+<class>@constellation.local) into a UUID. The email lookup is tenant-scoped to the caller; cross-tenant matches are not returned.

Request

Responses

200

Successful response

401

Unauthorized — authentication credentials are missing or invalid

403

Forbidden — the x-act-as-org selector named an organisation the caller is not an ACTIVE member of (or the caller lacks the required permission).