Privicore
  1. Device
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)
      POST
    • Retrieve unique identifier
      POST
    • Retrieve profile devices
      GET
    • Configure device meta
      POST
    • Approve device
      POST
    • Reject device
      POST
    • Retrieve device configuration
      GET
    • Remove device
      POST
  • Storage
    • Storage Device Management
    • Register storage device
    • List storage devices
    • Synchronize device
    • Remove storage
  • Verified authenticator
    • Authenticator and Voting Management
    • Register authenticator
    • List verified authenticators
    • Retrieve voting strategy
    • Set quorum size
    • Set quorum strategy
    • Set voting time limit
    • Set maximum voting attempts
    • Remove authenticator
    • Register voting configuration
    • Update voting configuration
    • List voting configurations
    • Retrieve voting configuration
  • 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
  • Schemas
    • Response
      • CommandAccepted
      • Unauthorized
      • ValidationErrors
    • Schemas
    • profileId
    • deviceIdentifier
    • directoryId
    • directoryName
    • directoryShortName
    • givenName
    • familyName
    • createdAt
    • meta
  1. Device

Request unique identifier (i.e. Register new device)

POST
/device/request-unique-identifier

Overview#

Initiate device registration by requesting a unique identifier from Privicore. This creates a pending device registration under the user's profile.

Request Unique Identifier#

Endpoint: POST /device/request-unique-identifier
Authentication: Required (Authorization token obtained from the step)

Use Case#

This is the first step in device registration. When third-party software needs to register as a Storage or Authenticator device, it requests a unique identifier that will serve as its device identity within Privicore.
The request creates a pending device registration associated with the authenticated user's profile. The device must subsequently retrieve this identifier, register a public key, and wait for user approval before becoming active.
This creates a pending device registration requiring user approval
The unique identifier serves as the device's identity in Privicore
After requesting, use the retrieve unique identifier endpoint to obtain the assigned ID
Device cannot participate in storage or authentication until approved

Request

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

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/device/request-unique-identifier' \
--header 'X-DPT-AUTHORIZATION: <api-key>'

Responses

🟢202Success
This response does not have a body.
🟠401401
Modified at 2025-12-24 12:23:56
Previous
Device Management
Next
Retrieve unique identifier
Built with