{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/system-management/refresh-keys","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/system-management/refresh-keys","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/system-management/refresh-keys","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/system-management/refresh-keys","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/system-management/refresh-keys","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/system-management/refresh-keys","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/system-management/refresh-keys","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Refresh user keys","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"refresh-user-keys","__idx":0},"children":["Refresh user keys"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If there is a suspicion that private keys were compromised, you need to lock the user account and recreate the account with new keys."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you refresh the user key, you need the user to re-register with the same user name and share the new public key with you."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The user can re-register with either the UI or API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, see:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/api/get-started/register#generate-a-key-pair-and-share-the-public-key"},"children":["Ripple Custody API > Generate a key pair and share the public key"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/ui/get-started/register#create-a-profile"},"children":["Ripple Custody UI > Create a profile"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"refresh-a-user-key","__idx":2},"children":["Refresh a user key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These steps describe how to refresh a user key with the API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To refresh a user key:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Make a note of the login provider information in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LoginIds"]},"."," ","For more information about how to retrieve the user information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/api/environment/user/view"},"children":["View user details"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create an intent of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UpdateUser"]}," to set the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LoginIds"]}," to null.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/api/get-started/key-operations/update/intent-proposal#propose-an-intent-to-update-an-entity"},"children":["Propose an intent to update an entity"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create an intent of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_LockUser"]}," to lock the user."," ","For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/api/get-started/key-operations/update/intent-proposal#propose-an-intent-to-lock-or-unlock-an-entity"},"children":["Propose an intent to lock or unlock an entity"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a user with:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The same user name, roles, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LoginIds"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The newly-generated public key",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/api/environment/user/create#create-a-user"},"children":["Create a user"]},"."]}]}]}]}]},"headings":[{"value":"Refresh user keys","id":"refresh-user-keys","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Refresh a user key","id":"refresh-a-user-key","depth":2}],"frontmatter":{"seo":{"title":"Refresh user keys"}},"lastModified":"2025-11-04T23:32:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.26/system-management/refresh-keys","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}