Set maximum voting attempts

Overview

Configure the maximum number of times a poll can be retried if it fails due to timeout or rejection.

Set Maximum Voting Attempts

Endpoint: POST /verified-authenticator/set-maximum-voting-attempts

Authentication: Required (Authorization token obtained from the step)

Content-Type: application/x-www-form-urlencoded

Request Parameters

Parameter	Type	Required	Description
`numberOfAttempts`	integer	Yes	Maximum number of voting attempts

Use Case

Use this endpoint to set how many times a failed poll can be retried. When a poll fails (due to timeout, insufficient quorum, or rejection), the system can automatically create a new poll for the same operation up to the maximum number of attempts.

Examples:

1 attempt: No retries - operation fails immediately if poll fails (strict security)

2 attempts: One retry allowed - gives users a second chance if they miss the first ballot

3 attempts: Two retries allowed - accommodates temporary device unavailability

Polls may fail due to:

Timeout (voting time limit expires without enough responses)

Quorum not met (insufficient Authenticators respond)

Rejection (votes do not meet strategy requirements)

Additional attempts give users more opportunities to respond, but also extend the total time an operation may be pending.

Maximum attempts apply to all polls unless overridden by specific configurations
Each attempt creates a new poll with fresh ballots sent to Authenticators
Total possible time = (time limit per poll) × (number of attempts)
Higher attempt counts improve availability but delay operation failure detection
Lower attempt counts provide faster failure responses but less flexibility
After maximum attempts are exhausted, the operation is permanently denied

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Command accepted.
Use DPT CAB websocket server to subscribe to your profile channel via authorization token and receive command status messages.

Headers

Body

Example

[
    "string"
]

Set maximum voting attempts

Overview#