Create voting

Overview

Manually create a poll for authorization, specifying the voting configuration and context for Authenticators to evaluate.

Endpoint: POST /voting/create

Authentication: Required (Authorization token obtained from the step)

Content-Type: application/json

Request Parameters

Parameter	Type	Required	Description
`votingConfigurationId`	string	Yes	Voting configuration identifier to apply to this poll
`question`	string	Yes	The question or action Authenticators are voting on
`title`	string	Yes	Brief title for the poll
`skipAuthenticatorDevices`	array[string]	No	Authenticator device identifiers to exclude from voting
`nonce`	string	No	External reference or context information to include with the poll

Use Case

Use this endpoint to create a manual poll for authorization outside of policy-driven workflows. The poll:

Uses the specified voting configuration for strategy, time limits, and quorum

Sends ballots to all registered Authenticators (except those in skipAuthenticatorDevices)

Presents the question and title to Authenticators for context

Includes optional nonce for tracking or external system integration

Example Scenarios:

Administrative Approval:

{
  "votingConfigurationId": "admin-approval-config",
  "question": "Approve adding John Smith to the Finance team?",
  "title": "Team Member Addition",
  "skipAuthenticatorDevices": [],
  "nonce": "hr-request-12345"
}

Exceptional Access:

{
  "votingConfigurationId": "high-security-config",
  "question": "Grant emergency access to production database?",
  "title": "Emergency Access Request",
  "skipAuthenticatorDevices": ["mobile-device-123"],
  "nonce": "incident-2024-001"
}

The response includes the poll identifier, which can be used with the check pool status endpoint to monitor voting progress.

Poll is created immediately and ballots are distributed to Authenticators
Voting configuration determines strategy, time limits, and quorum requirements
title and question should provide clear context for Authenticators
Use skipAuthenticatorDevices to exclude specific devices from voting
nonce can be used to correlate polls with external systems or tracking
Poll follows the same security model as policy-driven voting
Check pool status to monitor voting progress and outcome

Request

Authorization

API Key

Add parameter in header

X-DPT-AUTHORIZATION

Example:

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

Header Params

Body Params application/json

Example

{
    "votingConfigurationId": "example_voting_configuration_id",
    "question": "Example question",
    "title": "Example title",
    "skipAuthenticatorDevices": [
        ""
    ],
    "nonce": ""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Create voting

Overview#

Create Voting#

Request Parameters#

Use Case#

Request

Request Code Samples

Responses

Overview

Create Voting

Request Parameters

Use Case