auth.v1.MFAService
BeginPasskeyEnrollment
Start passkey enrollment.
Method
POST
Path
auth.v1.MFAService/BeginPasskeyEnrollment
Service
auth.v1.MFAService
Visibility
Authentication
Session token
MFA Requirement
POST
auth.v1.MFAService/BeginPasskeyEnrollment Request
Testnet
curl --request POST \ \
--url 'https://api.testnet.polyester.com/auth.v1.MFAService/BeginPasskeyEnrollment' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"label": "MacBook Touch ID"
}'Responses
{
"enrollmentId": "mfa_22222222222222222222222222222222",
"expiresAt": "2025-01-01T00:00:00Z",
"publicKey": {
"challenge": "Y2hhbGxlbmdlLWZvci1kb2Nz",
"rpId": "devnet.polyester.com"
}
}Request
auth.v1.BeginPasskeyEnrollmentRequestResponse
auth.v1.BeginPasskeyEnrollmentResponse label string
Optional human-friendly label for the passkey. Maximum 128 characters.
enrollmentId string
Enrollment challenge identifier. Format: "mfa_" followed by 32 lowercase hex characters.
1 field
2 fields
key string
TODO: description pending
6 fields
nullValue enum
Represents a null value.
NULL_VALUE
numberValue number
Represents a double value.
stringValue string
Represents a string value.
boolValue boolean
Represents a boolean value.
structValue object
Represents a structured value.
1 field
values object[]
Repeated field of dynamically typed values.
expiresAt string (date-time)
Time when this enrollment challenge expires.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |