List human users
GET /v1/users: Requires LIST_USER on the GoodMem instance and READ_USER on each returned row.
Requires LIST_USER on the GoodMem instance and READ_USER on each returned row. Authorization, label filtering, lifecycle filtering, and keyset pagination run in PostgreSQL. includeDeleted expands the lifecycle view but grants no access. includeEnrollmentSummary requests non-secret bootstrap posture only on active rows where MANAGE_USER_ENROLLMENT is independently authorized.
LABEL FILTERS: Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production).
ApiKeyAuthx-api-key<token>includeDeleted?booleanInclude readable permanent tombstones
falseincludeEnrollmentSummary?booleanRequest non-secret enrollment posture on active rows where the caller also has MANAGE_USER_ENROLLMENT
falsemaxResults?integerPage size; defaults to 50 and must be between 1 and 1000
int3250nextToken?stringOpaque continuation token
label?Filter by label key-value pairs. Label filters accept either label.<key>=<value> or label[key]=value (for example, label.environment=production or label[environment]=production).
{ "environment": "production", "team": "nlp"}GoodMem-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 page returned
application/json- response
One authorization-filtered page of human users.
users*array<>OUTPUT_ONLY; users in stable keyset order.
nextToken?|OUTPUT_ONLY; opaque continuation token, omitted after the final page.
curl -X GET 'https://your-goodmem-server.example.com/v1/users' \ -H 'GoodMem-Timeout-Ms: 30000'{ "users": [ { "userId": "550e8400-e29b-41d4-a716-446655440000", "email": "[email protected]", "displayName": "John Doe", "username": "johndoe", "enrollmentSummary": { "openEnrollmentExpiresAt": 1786752000000 }, "deletedAt": 1620200000000, "createdAt": 1620000000000, "updatedAt": 1620100000000 } ], "nextToken": "string"}List a human user's enrollments
GET /v1/users/{userId}/enrollments: Returns one newest-first page containing pending, expired, consumed, and revoked enrollment metadata.
Revoke a human-user enrollment
DELETE /v1/users/{userId}/enrollments/{enrollmentId}: Permanently revokes one outstanding enrollment after requiring MANAGE_USER_ENROLLMENT on its target user.