Register voting configuration

Overview

Create a new voting configuration with specific parameters that can be applied to particular operations or workflows.

Register Voting Configuration

Endpoint: POST /verified-authenticator/voting-configuration/register

Authentication: Required (Authorization token obtained from the step)

Content-Type: application/json

Request Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Unique name for the voting configuration
`timeLimit`	integer	Yes	Time limit for voting in seconds
`strategy`	string	Yes	Voting strategy to use
`percentageRequired`	integer	No	Minimum vote percentage (0-100) for `minimum_percentage` strategy
`deviceIdentifiers`	array[string]	Yes	Authenticator device identifiers. Empty array applies to all profile Authenticators

Available Strategies:

Strategy	Description	percentageRequired
`unanimous`	All responding Authenticators must vote "yes"	Not used
`consensus`	Majority of responding Authenticators must vote "yes"	Not used
`affirmative`	At least one Authenticator must vote "yes"	Not used
`minimum_percentage`	Specific percentage must vote "yes"	Required (e.g., 75)

Use Case

Use this endpoint to create named voting configurations for specific operation types or workflows. This enables:

Operation-specific configurations: Different voting rules for login vs. account deletion

Device-specific voting: Limit voting to specific Authenticators for certain operations

Reusable configurations: Create once, apply to multiple operation types

Configuration management: Named configurations are easier to track and update

Examples:

High-security configuration:

{
  "name": "high-security",
  "timeLimit": 300,
  "strategy": "unanimous",
  "deviceIdentifiers": []
}

Quick approval configuration:

{
  "name": "quick-approval",
  "timeLimit": 60,
  "strategy": "affirmative",
  "deviceIdentifiers": ["device-123", "device-456"]
}

Custom threshold configuration:

{
  "name": "two-thirds-approval",
  "timeLimit": 180,
  "strategy": "minimum_percentage",
  "percentageRequired": 67,
  "deviceIdentifiers": []
}

Configuration names must be unique within your profile
Empty deviceIdentifiers array applies configuration to all profile Authenticators
Specify device identifiers to limit voting to specific Authenticators
percentageRequired is only used with minimum_percentage strategy
Configurations can be applied to specific operations via policies
Update existing configurations using the update voting configuration endpoint

Request

Authorization

API Key

Add parameter in header

X-DPT-AUTHORIZATION

Example:

X-DPT-AUTHORIZATION: ********************

Header Params

Body Params application/json

Example

{
    "name": "default",
    "timeLimit": 60,
    "strategy": "unanimous",
    "percentageRequired": null,
    "deviceIdentifiers": [
        ""
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Register voting configuration

Overview#