Search User

Find a member of the caller’s organization by email.

Users outside the caller’s organization return 404, the same as an unknown email, so the route cannot be used to enumerate accounts. Platform admins are scoped the same way; platform-wide lookups go through /admin/users.

GET /users/search

Error

A valid request URL is required to generate request examples

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email": "[e-mail]",
  "first_name": "<string>",
  "last_name": "<string>"
}

Authorizations

fastapiusersauth · string · cookie · required

Query Parameters

email · string<email> | null

workspace_id · string<uuid> | null

Response

200

application/json

Successful Response

Identity fields returned by the org-scoped user email search.

id · string<uuid> · required

email · string<email> · required

first_name · string | null

last_name · string | null