GoodMemCreate a human-user enrollment
POST /v1/users/{userId}/enrollments: Creates a short-lived, one-time enrollment credential for an existing dormant human.
Creates a short-lived, one-time enrollment credential for an existing dormant human. Requires MANAGE_USER_ENROLLMENT with ANY or EXACT authority on the target user. The raw credential is returned only once. rotateExisting atomically revokes and replaces a live enrollment; an expired enrollment is replaced automatically.
In: header
Path Parameters
Human-user UUID
Header Parameters
Optional 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 <= 86400000Optional client-provided enrollment UUID; generated when omitted.
"0198b9f4-c42f-7ae3-8c56-44d827ea03bd"uuidWhether an existing live enrollment may be revoked and atomically replaced.
falseResponse Body
curl -X POST "https://your-goodmem-server.example.com/v1/users/70e025f6-76ca-4cbe-b8fc-7dab8e84590a/enrollments" \ -H "GoodMem-Timeout-Ms: 30000" \ -H "Content-Type: application/json" \ -d '{ "enrollmentId": "0198b9f4-c42f-7ae3-8c56-44d827ea03bd" }'{
"enrollment": {
"enrollmentId": "0198b9f4-c42f-7ae3-8c56-44d827ea03bd",
"userId": "70e025f6-76ca-4cbe-b8fc-7dab8e84590a",
"credentialPrefix": "gme_mzxw6y",
"status": "PENDING",
"expiresAt": 1786752000000,
"consumedApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": 1786665600000,
"consumedAt": 1786669200000,
"revokedAt": 1786669200000,
"createdById": "b3303d0a-1a4a-493f-b9bf-38e37153b5a2",
"revokedById": "b3303d0a-1a4a-493f-b9bf-38e37153b5a2"
},
"enrollmentToken": "gme_mzxw6ytboiww6z3foj2xezltoqxxezltoqxxezltoqxxezltoqxa"
}