GoodMemGet user by email address
GET /v1/users/email/{email}: Returns a user selected by exact email address after applying READ_USER authority.
Returns a user selected by exact email address after applying READ_USER authority. includeDeleted permits an authorized caller to inspect a permanent tombstone; it does not grant additional authority. Missing and unauthorized matches both return 404 so this guessable identifier cannot reveal whether a user exists.
ApiKeyAuthx-api-key<token>email*stringURL-encoded email address
includeDeleted?booleanPermit an authorized read of a permanent tombstone
falseGoodMem-Timeout-Ms?integerOptional waiting budget in milliseconds, measured from REST servlet ingress and shared across all internal gRPC calls. Supply one decimal integer from 1 to 86400000. Omission adds no deadline. Existing shorter deadlines still apply. Expiry returns HTTP 504 before streaming starts; after streaming starts, no successful completion event is sent. Use SSE or opt into GoodMem-Stream-Terminal for an explicit terminal outcome. Retrieval work is cooperatively cancelled. An accepted mutation may still commit after timeout or disconnect; a failed response does not imply rollback.
int641 <= value <= 86400000User returned
application/json- response
A durable human user profile and its lifecycle metadata.
userId*stringOUTPUT_ONLY; immutable user UUID.
uuid"550e8400-e29b-41d4-a716-446655440000"email*stringOUTPUT_ONLY; unique email address.
"[email protected]"displayName?|OUTPUT_ONLY; optional human-facing display name.
"John Doe"username?|OUTPUT_ONLY; optional unique username.
"johndoe"labels*OUTPUT_ONLY; mutable labels attached to the user principal. At most 20 entries; keys and values contain at most 255 characters; keys use [a-z0-9._-].
properties <= 20{ "team": "platform"}enrollmentSummary?|OUTPUT_ONLY; enrollment posture when requested and independently authorized.
{ "openEnrollmentExpiresAt": 1786752000000}deletedAt?|OUTPUT_ONLY; permanent deletion time in milliseconds, absent while active.
int641620200000000deletedById?|OUTPUT_ONLY; exact deleting actor UUID, absent while active.
uuidcreatedAt*integerOUTPUT_ONLY; creation time in milliseconds since the epoch.
int641620000000000updatedAt*integerOUTPUT_ONLY; most recent mutation time in milliseconds since the epoch.
int641620100000000createdById*stringOUTPUT_ONLY; exact creating actor UUID.
uuidupdatedById*stringOUTPUT_ONLY; exact actor UUID for the most recent mutation.
uuidcurl -X GET 'https://your-goodmem-server.example.com/v1/users/email/[email protected]' \ -H 'GoodMem-Timeout-Ms: 30000'{ "userId": "550e8400-e29b-41d4-a716-446655440000", "email": "[email protected]", "displayName": "John Doe", "username": "johndoe", "labels": { "team": "platform" }, "enrollmentSummary": { "openEnrollmentExpiresAt": 1786752000000 }, "deletedAt": 1620200000000, "deletedById": "8ef578ad-7f1e-4656-b48b-b1b4a9aaa1cb", "createdAt": 1620000000000, "updatedAt": 1620100000000, "createdById": "e13e432a-5323-4484-a91d-b5969bc564d9", "updatedById": "d8bc6076-4141-4a88-80b9-0eb31643066f"}