Privicore
  1. Verified authenticator
Privicore
  • Privicore API
  • Utility
    • Utility
    • Check server health
      GET
    • Request command id status
      GET
  • Profile
    • Profile Model and Authentication Workflow
    • Register new profile
      POST
    • Authenticate
      POST
    • Retrieve profile id
      GET
    • Change password
      POST
    • Generate qr token for authorization
      POST
    • Reauthorize authorization token
      POST
    • Revoke authorization token
      POST
    • Retrieve token expiry
      POST
  • OAuth Application
    • OAuth Application Management
    • Register OAuth Application
      POST
    • Retrieve OAuth app configuration
      POST
    • Request OAuth app authorization code
      GET
    • Retrieve OAuth app authorization code
      POST
    • Obtain OAuth app access token
      POST
    • OAuth application list
      GET
    • Retrieve OAuth application scope
      GET
    • Refresh OAuth app access token
      POST
  • Public key
    • Public and Private Key Management
    • Generate your private and public keys
    • Register public key
    • Retrieve public key
    • Retrieve CAB public key
  • Data Token
    • Data Token Management
    • Reserve token space
    • Retrieve temporary data token
    • Exchange data for token
    • Upstream file via stream auth
    • Request data via token
    • Download data
    • Configure information security risk meta
    • Configure file meta
    • List data tokens
    • Update data token
    • Delete data
  • Device
    • Device Management
    • Request unique identifier (i.e. Register new device)
    • Retrieve unique identifier
    • Retrieve profile devices
    • Configure device meta
    • Approve device
    • Reject device
    • Retrieve device configuration
    • Remove device
  • Storage
    • Storage Device Management
    • Register storage device
    • List storage devices
    • Synchronize device
    • Remove storage
  • Verified authenticator
    • Authenticator and Voting Management
    • Register authenticator
      POST
    • List verified authenticators
      GET
    • Retrieve voting strategy
      GET
    • Set quorum size
      POST
    • Set quorum strategy
      POST
    • Set voting time limit
      POST
    • Set maximum voting attempts
      POST
    • Remove authenticator
      POST
    • Register voting configuration
      POST
    • Update voting configuration
      POST
    • List voting configurations
      GET
    • Retrieve voting configuration
      GET
  • Policy
    • Policy Management
    • List policy templates
    • Register policy
    • List active policies
    • List inactive policies
    • Activate policy
    • Deactivate policy
    • Delete policy
    • List registered policies
    • Retrieve registered policy
  • Voting
    • Voting Operations
    • Create voting
    • Check pool status
  • Websockets
    • WebSocket Integration
    • Establishing Connection
    • Join Channel
    • Leave Channel
    • Command Status Messages
    • Data Download Messages
  • Schemas
    • Response
      • CommandAccepted
      • Unauthorized
      • ValidationErrors
    • Schemas
    • profileId
    • deviceIdentifier
    • directoryId
    • directoryName
    • directoryShortName
    • givenName
    • familyName
    • createdAt
    • meta
  1. Verified authenticator

Update voting configuration

POST
/verified-authenticator/voting-configuration/update

Overview#

Update an existing voting configuration with new parameters.

Update Voting Configuration#

Endpoint: POST /verified-authenticator/voting-configuration/update
Authentication: Required (Authorization token obtained from the step)
Content-Type: application/json

Request Parameters#

ParameterTypeRequiredDescription
configurationIdstringNoThe unique identifier of the configuration to update
namestringYesUpdated name for the voting configuration
timeLimitintegerYesTime limit for voting in seconds
strategystringYesVoting strategy to use
percentageRequiredintegerNoMinimum vote percentage (0-100) for minimum_percentage strategy
deviceIdentifiersarray[string]NoAuthenticator device identifiers. Empty array applies to all profile Authenticators
Available Strategies:
StrategyDescription
unanimousAll responding Authenticators must vote "yes"
consensusMajority of responding Authenticators must vote "yes"
affirmativeAt least one Authenticator must vote "yes"
minimum_percentageSpecific percentage must vote "yes" (requires percentageRequired)

Use Case#

Use this endpoint to modify an existing voting configuration. This is useful when:
Security requirements change for specific operations
Adjusting time limits based on user feedback
Changing voting strategies to balance security and usability
Adding or removing specific Authenticators from configuration
Updating percentage thresholds for custom approval requirements
Updates to voting configurations apply to new polls created after the update. Active polls continue using the configuration that was in effect when they were created.
Specify configurationId to update a specific configuration
Updates apply to future polls - active polls use original configuration
Empty deviceIdentifiers array applies configuration to all profile Authenticators
percentageRequired is only used with minimum_percentage strategy
Configuration name can be changed if the new name is unique
Use list voting configurations to retrieve configuration IDs

Request

Authorization
API Key
Add parameter in header
X-DPT-AUTHORIZATION
Example:
X-DPT-AUTHORIZATION: ********************
or
Header Params

Body Params application/json

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

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.privicore.com:9009/verified-authenticator/voting-configuration/update' \
--header 'X-DPT-AUTHORIZATION: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "configurationId": "voting_configuration_id",
    "name": "default",
    "timeLimit": 60,
    "strategy": "unanimous",
    "percentageRequired": null,
    "deviceIdentifiers": [
        ""
    ]
}'

Responses

🟢202Success
This response does not have a body.
🟠401401
🟠422422
Modified at 2025-12-30 11:37:56
Previous
Register voting configuration
Next
List voting configurations
Built with