Update Passphrase

PUT /byron-wallets/{walletId}/passphrase

status: stable

Path parameters

  • walletId string(hex) Required

    Minimum length is 40, maximum length is 40.

application/json

Body Required

  • old_passphrase string

    The current passphrase if present.

    Minimum length is 0, maximum length is 255.

  • new_passphrase string Required

    A master passphrase to lock and protect the wallet for sensitive operation (e.g. sending funds).

    Minimum length is 10, maximum length is 255.

Responses

  • 415 application/json

    Unsupported Media Type

    Hide response attributes Show response attributes object
    • message string Required

      May occur when providing an invalid 'Content-Type' header.

    • code string Required

      Value is unsupported_media_type.
  • 406 application/json

    Not Acceptable

    Hide response attributes Show response attributes object
    • message string Required

      May occur when providing an invalid 'Accept' header.

    • code string Required

      Value is not_acceptable.
  • 404 application/json

    Not Found

    Hide response attributes Show response attributes object
    • message string Required

      May occur when a given walletId does not match with any known wallets (because it has been deleted, or has never existed).

    • code string Required

      Value is no_such_wallet.

    • info object
      Hide info attribute Show info attribute object
      • wallet_id string(hex) Required

        A unique identifier for the wallet

        Minimum length is 40, maximum length is 40.
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • message string Required

      May occur when a request is not well-formed; that is, it fails to parse successfully. This could be the case when some required parameters are missing or, when malformed values are provided.

    • code string Required

      Value is bad_request.
  • 403 application/json

    Forbidden

    One of:
    no_root_key object wrong_encryption_passphrase object wrong_mnemonics object
  • 204

    No Content

PUT /byron-wallets/{walletId}/passphrase 
curl \
 --request PUT https://localhost:8090/v2/byron-wallets/{walletId}/passphrase \
 --header "Content-Type: application/json" \
 --data '{"old_passphrase":"Secure Passphrase","new_passphrase":"Secure Passphrase"}'
Request examples 
{
  "old_passphrase": "Secure Passphrase",
  "new_passphrase": "Secure Passphrase"
}
Response examples (415) 
{
  "message": "string",
  "code": "unsupported_media_type"
}
Response examples (406) 
{
  "message": "string",
  "code": "not_acceptable"
}
Response examples (404) 
{
  "message": "string",
  "code": "no_such_wallet",
  "info": {
    "wallet_id": "2512a00e9653fe49a44a5886202e24d77eeb998f"
  }
}
Response examples (400) 
{
  "message": "string",
  "code": "bad_request"
}
Response examples (403) 
{
  "message": "string",
  "code": "no_root_key"
}
{
  "message": "string",
  "code": "wrong_encryption_passphrase",
  "info": {
    "wallet_id": "2512a00e9653fe49a44a5886202e24d77eeb998f"
  }
}
{
  "message": "string",
  "code": "wrong_mnemonic"
}