Norsh
Home
NTPNCLAPI
Home
NTPNCLAPI
  1. Address
  • Norsh
    • Usage Guide
      • Identity in the Norsh Ecosystem
      • UCP Message Structure (Standard Request Format)
    • API
      • UCP Error Codes
      • Keys Identity
        • Generates a public and private key pair
      • Address
        • Register Address
          POST
        • Get Address
          POST
        • Enable TOTP
          POST
        • Disable TOTP
          POST
        • Enable Secret-Based Authentication
          POST
        • Disable Secret-Based Authentication
          POST
        • Revoke Address
          POST
      • Modules
        • Get Module
        • Create Notary
      • Statements
        • Get Statement
        • Create Notary Statement
      • BigLedger
        • Get BigLedger Statement
      • Tartarus
        • Get Tartarus Statement
      • Envelopes
        • Get Envelope
  • NTP - Norsh Technical Paper
    • NTP-1: Norsh Technical Paper Specification
    • NTP-2: Standards for Encoding, Time and Localization
    • NTP-3: Cryptography and Hash Specification
    • NTP-4: Interchangeable Data Standard
    • NTP-5: Temporal Time-Step Model
    • NTP-6: Modular Prime Fragmentation
    • NTP-7: The End of Mining - PoW
    • NTP-8: The Fallacy of Stake - PoS
    • NTP-9: The Myth of Absolute Non-Censorship
    • NTP-10: Structural Failures of Decentralization
    • NTP-11: Universal Blockchain Protocol (UBP)
    • NTP-12: Sharded Certificate Storage for the Norsh Ecosystem
  • NCL - Norsh Commons License
    • NCL-0: Norsh Commons License
    • NCL-1: Attribution Requirement
    • NCL-2: Restricted Commercialization
    • NCL-4: Commercialization with Agreement or Royalties
    • NCL-8: Educational Use Permission
    • NCL-16: Complementary Use and Integration Permission
    • NCL-32: Pre-Approval for Application Publication
    • NCL-64: Restricted or Authorized Derivatives
    • NCL-128: Contribution Terms
  • Compliance
    • Terms of Use
    • Privacy Policy
    • Norsh Brand and Trademark Usage Guidelines
    • AI Content Notice
    • Credits
    • Partners
    • Legal Templates
      • Policy on Public Disclosure of Legal Templates
      • NDA - Template
      • Service Agreement - Template
  • Resources
    • Norsh Brand Guidelines
    • Academy
      • Exam Program
  • Service Operations
    • Service Level Agreement (SLA)
    • Scheduled Maintenance Notice
    • Incident Reports
  • Schemas
    • Key & Address
      • Key.Generate
      • Address.Register
      • Address.Revoke
      • Address.TOTP.Enable
      • Address.TOTP.Disable
      • Address.Secret.Enable
      • Address.Secret.Disable
    • Modules
      • Module.Notary.Create
      • Module.Meter.Create
    • Ucp Response
    • Ucp PublicKey
    • Ucp Parameters
    • Ucp Header
    • Ucp Ghost
Home
NTPNCLAPI
Home
NTPNCLAPI
  1. Address

Disable TOTP

POST
https://sandbox.norsh.org/{network}/v1/ucp
Last modified:2025-10-30 03:54:40
This API disables Time-based One-Time Password (TOTP) authentication for a cryptographic address in the Norsh ecosystem.
A valid TOTP code must be provided in the ghost.totp field to authorize deactivation.
If the address is already configured with a static secret, the ghost.secret field must also be provided.
Request:
This endpoint uses the UCP standard request format. In addition to the standard fields, specify the following fields for this operation:
command: Set to keys.totp.disable.
ghost (object, required): Transactional data (not persisted).
totp (string, required): The current valid 6-digit TOTP code for disabling TOTP on the address.
secret (string, required if the address is configured with a static secret): The current static secret for additional verification.
Response:
Confirmation that TOTP protection has been disabled for the specified address.
Notes:
Disabling TOTP requires a valid 30-second TOTP code provided in the ghost.totp field.
If the address is configured with a static secret, the ghost.secret field is also required.
Once disabled, subsequent operations for this address will no longer require TOTP validation.
If the TOTP code is invalid or expired, the request will be rejected with a DualUnauthorized response.

Request

Path Params

Body Params application/vnd.ucp+json

Examples

Responses

🟢200Success
application/vnd.ucp+json
Body

🟠422Parameter Error
🟢207Multi-Status
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.norsh.org//v1/ucp' \
--header 'Content-Type: application/vnd.ucp+json' \
--data-raw '[
    {
        "command": "address.totp.disable",
        "version": 1,
        "parameters": {},
        "publicKey": "MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEoVOBV/Ji7NfdOA8RAqpvqLQ7qnzuUHESOL/6Oosdg4/un0+YU+7QVX5L3sjXbbxYLQeYa4XPI7n5pKKOxNn2Qu7rsvY+CkHXW+lxzGKen9JA4EfnlWteM5KI3JYvH/Pj",
        "signature": "MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEoVOBV/Ji7NfdOA8RAqpvqLQ7qnzuUHESOL/6Oosdg4/un0+YU+7QVX5L3sjXbbxYLQeYa4XPI7n5pKKOxNn2Qu7rsvY+CkHXW+lxzGKen9JA4EfnlWteM5KI3JYvH/Pj",
        "ghost": {
            "totp": 123456
        }
    }
]'
Response Response Example
200 - Success
[
    {
        "command": "keys.totp.disable",
        "version": 1,
        "status": 200,
        "timestamp": "2025-09-22T03:15:52.48Z",
        "success": true,
        "result": "TOTP has been disabled for this address.",
        "info": {
            "ledger": "bigledger",
            "statement": "69017c0f7fc2f1cacffed2ffc6ee937bba47d339c38390dc6c1380a85adc0244d83c197a7d603d513660c7f08618cb4b",
            "envelope": "78334f0b0e1c8696e74f30833ae9b024494d84996121ce1745126c7e468079db5fdb46327837ebaba1524a7e67f9d623",
            "duration": 77
        }
    }
]
Modified at 2025-10-30 03:54:40
Previous
Enable TOTP
Next
Enable Secret-Based Authentication
Built with