@turnkey/http 1.3.0 → 2.0.0

package/dist/__generated__/services/coordinator/public/v1/public_api.swagger.json

@@ -22,9 +22,17 @@
             "name": "Policies",
             "description": "Policies allow for deep customization of the security of your Organization. They can be used to grant permissions or restrict usage of Users and Private Keys. The Policy Engine analyzes all of your Policies on each request to determine whether an Activity is allowed.\n\nSee [Policy Overview](../managing-policies/overview) for more information"
         },
+        {
+            "name": "Wallets",
+            "description": "Wallets contain collections of deterministically generated cryptographic public / private key pairs that share a common seed. Turnkey securely holds the common seed, but only you can access it. In most cases, Wallets should be preferred over Private Keys since they can be represented by a mnemonic phrase, used across a variety of cryptographic curves, and can derive many addresses."
+        },
+        {
+            "name": "Signatures",
+            "description": "Signatures are used to validate the authenticity and integrity of a digital message. Signatures are a fundamental building block in blockchains. Turnkey makes it easy to produce signatures by allowing you to sign with an address. If Turnkey doesn't yet support an address format you need, you can generate and sign with the public key instead by using the address format `ADDRESS_FORMAT_COMPRESSED`."
+        },
         {
             "name": "Private Keys",
-            "description": "Private Keys are cryptographic public / private key pairs that can be used for cryptocurrency needs or more generalized encryption. Think of Private Keys as your own programmable wallet. Turnkey securely holds all Private Key materials for you, but only you can access them."
+            "description": "Private Keys are cryptographic public / private key pairs that can be used for cryptocurrency needs or more generalized encryption. Turnkey securely holds all Private Key materials for you, but only you can access them."
         },
         {
             "name": "Private Key Tags",
@@ -799,7 +807,7 @@
         "/public/v1/submit/create_wallet": {
             "post": {
                 "summary": "Create Wallet",
-                "description": "Create a Wallet",
+                "description": "Create a Wallet and derive addresses",
                 "operationId": "PublicApiService_CreateWallet",
                 "responses": {
                     "200": {
@@ -825,13 +833,13 @@
                         }
                     }
                 ],
-                "tags": ["PublicApiService"]
+                "tags": ["Wallets"]
             }
         },
         "/public/v1/submit/create_wallet_accounts": {
             "post": {
-                "summary": "Create Wallet accounts",
-                "description": "Create Wallet accounts",
+                "summary": "Create Wallet Accounts",
+                "description": "Derive additional addresses using an existing wallet",
                 "operationId": "PublicApiService_CreateWalletAccounts",
                 "responses": {
                     "200": {
@@ -857,7 +865,7 @@
                         }
                     }
                 ],
-                "tags": ["PublicApiService"]
+                "tags": ["Wallets"]
             }
         },
         "/public/v1/submit/delete_api_keys": {
@@ -924,7 +932,7 @@
                 "tags": ["Authenticators"]
             }
         },
-        "/public/v1/submit/delete_invitations": {
+        "/public/v1/submit/delete_invitation": {
             "post": {
                 "summary": "Delete Invitation",
                 "description": "Delete an existing Invitation",
@@ -1020,11 +1028,11 @@
                 "tags": ["Private Keys"]
             }
         },
-        "/public/v1/submit/init_user_email_recovery": {
+        "/public/v1/submit/export_wallet": {
             "post": {
-                "summary": "Init Recovery",
-                "description": "Initializes a new recovery",
-                "operationId": "PublicApiService_InitUserEmailRecovery",
+                "summary": "Export Wallet",
+                "description": "Exports a Wallet",
+                "operationId": "PublicApiService_ExportWallet",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1045,18 +1053,18 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1InitUserEmailRecoveryRequest"
+                            "$ref": "#/definitions/v1ExportWalletRequest"
                         }
                     }
                 ],
-                "tags": ["Organizations"]
+                "tags": ["Wallets"]
             }
         },
-        "/public/v1/submit/reject_activity": {
+        "/public/v1/submit/init_user_email_recovery": {
             "post": {
-                "summary": "Reject Activity",
-                "description": "Reject an Activity",
-                "operationId": "PublicApiService_RejectActivity",
+                "summary": "Init Email Recovery",
+                "description": "Initializes a new email recovery",
+                "operationId": "PublicApiService_InitUserEmailRecovery",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1077,18 +1085,18 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1RejectActivityRequest"
+                            "$ref": "#/definitions/v1InitUserEmailRecoveryRequest"
                         }
                     }
                 ],
-                "tags": ["Consensus"]
+                "tags": ["User Recovery"]
             }
         },
-        "/public/v1/submit/remove_organization_feature": {
+        "/public/v1/submit/recover_user": {
             "post": {
-                "summary": "Remove Organization Feature",
-                "description": "Removes an organization feature",
-                "operationId": "PublicApiService_RemoveOrganizationFeature",
+                "summary": "Recover a user",
+                "description": "Completes the process of recovering a user by adding an authenticator",
+                "operationId": "PublicApiService_RecoverUser",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1109,18 +1117,18 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1RemoveOrganizationFeatureRequest"
+                            "$ref": "#/definitions/v1RecoverUserRequest"
                         }
                     }
                 ],
-                "tags": ["Organizations"]
+                "tags": ["User Recovery"]
             }
         },
-        "/public/v1/submit/set_organization_feature": {
+        "/public/v1/submit/reject_activity": {
             "post": {
-                "summary": "Set Organization Feature",
-                "description": "Sets an organization feature",
-                "operationId": "PublicApiService_SetOrganizationFeature",
+                "summary": "Reject Activity",
+                "description": "Reject an Activity",
+                "operationId": "PublicApiService_RejectActivity",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1141,18 +1149,18 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1SetOrganizationFeatureRequest"
+                            "$ref": "#/definitions/v1RejectActivityRequest"
                         }
                     }
                 ],
-                "tags": ["Organizations"]
+                "tags": ["Consensus"]
             }
         },
-        "/public/v1/submit/sign_raw_payload": {
+        "/public/v1/submit/remove_organization_feature": {
             "post": {
-                "summary": "Sign Raw Payload",
-                "description": "Sign a raw payload with a Private Key",
-                "operationId": "PublicApiService_SignRawPayload",
+                "summary": "Remove Organization Feature",
+                "description": "Removes an organization feature",
+                "operationId": "PublicApiService_RemoveOrganizationFeature",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1173,18 +1181,18 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1SignRawPayloadRequest"
+                            "$ref": "#/definitions/v1RemoveOrganizationFeatureRequest"
                         }
                     }
                 ],
-                "tags": ["Private Keys"]
+                "tags": ["Features"]
             }
         },
-        "/public/v1/submit/sign_raw_payload_v2": {
+        "/public/v1/submit/set_organization_feature": {
             "post": {
-                "summary": "Sign Raw Payload",
-                "description": "Sign a raw payload with a Private Key id or address",
-                "operationId": "PublicApiService_SignRawPayloadV2",
+                "summary": "Set Organization Feature",
+                "description": "Sets an organization feature",
+                "operationId": "PublicApiService_SetOrganizationFeature",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1205,18 +1213,18 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1SignRawPayloadV2Request"
+                            "$ref": "#/definitions/v1SetOrganizationFeatureRequest"
                         }
                     }
                 ],
-                "tags": ["PublicApiService"]
+                "tags": ["Features"]
             }
         },
-        "/public/v1/submit/sign_transaction": {
+        "/public/v1/submit/sign_raw_payload": {
             "post": {
-                "summary": "Sign Transaction",
-                "description": "Sign a transaction with a Private Key",
-                "operationId": "PublicApiService_SignTransaction",
+                "summary": "Sign Raw Payload",
+                "description": "Sign a raw payload",
+                "operationId": "PublicApiService_SignRawPayload",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1237,18 +1245,18 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1SignTransactionRequest"
+                            "$ref": "#/definitions/v1SignRawPayloadRequest"
                         }
                     }
                 ],
-                "tags": ["Private Keys"]
+                "tags": ["Signatures"]
             }
         },
-        "/public/v1/submit/sign_transaction_v2": {
+        "/public/v1/submit/sign_transaction": {
             "post": {
                 "summary": "Sign Transaction",
-                "description": "Sign a transaction with a Private Key id or address",
-                "operationId": "PublicApiService_SignTransactionV2",
+                "description": "Sign a transaction",
+                "operationId": "PublicApiService_SignTransaction",
                 "responses": {
                     "200": {
                         "description": "A successful response.",
@@ -1269,11 +1277,11 @@
                         "in": "body",
                         "required": true,
                         "schema": {
-                            "$ref": "#/definitions/v1SignTransactionV2Request"
+                            "$ref": "#/definitions/v1SignTransactionRequest"
                         }
                     }
                 ],
-                "tags": ["PublicApiService"]
+                "tags": ["Signatures"]
             }
         },
         "/public/v1/submit/update_allowed_origins": {
@@ -1305,7 +1313,7 @@
                         }
                     }
                 ],
-                "tags": ["Organizations"]
+                "tags": ["Features"]
             }
         },
         "/public/v1/submit/update_policy": {
@@ -1969,7 +1977,9 @@
                 "ACTIVITY_TYPE_REMOVE_ORGANIZATION_FEATURE",
                 "ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2",
                 "ACTIVITY_TYPE_SIGN_TRANSACTION_V2",
-                "ACTIVITY_TYPE_EXPORT_PRIVATE_KEY"
+                "ACTIVITY_TYPE_EXPORT_PRIVATE_KEY",
+                "ACTIVITY_TYPE_EXPORT_WALLET",
+                "ACTIVITY_TYPE_CREATE_SUB_ORGANIZATION_V4"
             ]
         },
         "v1ApiKey": {
@@ -2807,12 +2817,43 @@
                 "privateKeys"
             ]
         },
+        "v1CreateSubOrganizationIntentV4": {
+            "type": "object",
+            "properties": {
+                "subOrganizationName": {
+                    "type": "string",
+                    "description": "Name for this sub-organization"
+                },
+                "rootUsers": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "$ref": "#/definitions/v1RootUserParams"
+                    },
+                    "description": "Root users to create within this sub-organization"
+                },
+                "rootQuorumThreshold": {
+                    "type": "integer",
+                    "format": "int32",
+                    "description": "The threshold of unique approvals to reach root quorum. This value must be less than or equal to the number of root users"
+                },
+                "wallet": {
+                    "$ref": "#/definitions/v1WalletParams",
+                    "description": "The wallet to create for the sub-organization"
+                },
+                "disableEmailRecovery": {
+                    "type": "boolean",
+                    "description": "Disable email recovery for the sub-organization"
+                }
+            },
+            "required": ["subOrganizationName", "rootUsers", "rootQuorumThreshold"]
+        },
         "v1CreateSubOrganizationRequest": {
             "type": "object",
             "properties": {
                 "type": {
                     "type": "string",
-                    "enum": ["ACTIVITY_TYPE_CREATE_SUB_ORGANIZATION_V3"]
+                    "enum": ["ACTIVITY_TYPE_CREATE_SUB_ORGANIZATION_V4"]
                 },
                 "timestampMs": {
                     "type": "string",
@@ -2823,7 +2864,7 @@
                     "description": "Unique identifier for a given Organization."
                 },
                 "parameters": {
-                    "$ref": "#/definitions/v1CreateSubOrganizationIntentV3"
+                    "$ref": "#/definitions/v1CreateSubOrganizationIntentV4"
                 }
             },
             "required": ["type", "timestampMs", "organizationId", "parameters"]
@@ -2854,6 +2895,18 @@
             },
             "required": ["subOrganizationId", "privateKeys"]
         },
+        "v1CreateSubOrganizationResultV4": {
+            "type": "object",
+            "properties": {
+                "subOrganizationId": {
+                    "type": "string"
+                },
+                "wallet": {
+                    "$ref": "#/definitions/v1WalletResult"
+                }
+            },
+            "required": ["subOrganizationId"]
+        },
         "v1CreateUserTagIntent": {
             "type": "object",
             "properties": {
@@ -3473,6 +3526,59 @@
             },
             "required": ["privateKeyId", "exportBundle"]
         },
+        "v1ExportWalletIntent": {
+            "type": "object",
+            "properties": {
+                "walletId": {
+                    "type": "string",
+                    "description": "Unique identifier for a given Wallet."
+                },
+                "targetPublicKey": {
+                    "type": "string",
+                    "description": "Client-side public key generated by the user, to which the export bundle will be encrypted."
+                },
+                "language": {
+                    "$ref": "#/definitions/v1MnemonicLanguage",
+                    "description": "The language of the mnemonic to export. Defaults to English."
+                }
+            },
+            "required": ["walletId", "targetPublicKey"]
+        },
+        "v1ExportWalletRequest": {
+            "type": "object",
+            "properties": {
+                "type": {
+                    "type": "string",
+                    "enum": ["ACTIVITY_TYPE_EXPORT_WALLET"]
+                },
+                "timestampMs": {
+                    "type": "string",
+                    "description": "Timestamp (in milliseconds) of the request, used to verify liveness of user requests."
+                },
+                "organizationId": {
+                    "type": "string",
+                    "description": "Unique identifier for a given Organization."
+                },
+                "parameters": {
+                    "$ref": "#/definitions/v1ExportWalletIntent"
+                }
+            },
+            "required": ["type", "timestampMs", "organizationId", "parameters"]
+        },
+        "v1ExportWalletResult": {
+            "type": "object",
+            "properties": {
+                "walletId": {
+                    "type": "string",
+                    "description": "Unique identifier for a given Wallet."
+                },
+                "exportBundle": {
+                    "type": "string",
+                    "description": "Export bundle containing a wallet mnemonic + optional newline passphrase encrypted by the client's target public key."
+                }
+            },
+            "required": ["walletId", "exportBundle"]
+        },
         "v1Feature": {
             "type": "object",
             "properties": {
@@ -3998,6 +4104,12 @@
                 },
                 "exportPrivateKeyIntent": {
                     "$ref": "#/definitions/v1ExportPrivateKeyIntent"
+                },
+                "exportWalletIntent": {
+                    "$ref": "#/definitions/v1ExportWalletIntent"
+                },
+                "createSubOrganizationIntentV4": {
+                    "$ref": "#/definitions/v1CreateSubOrganizationIntentV4"
                 }
             },
             "required": ["createOrganizationIntent"]
@@ -4098,6 +4210,20 @@
                 "INVITATION_STATUS_REVOKED"
             ]
         },
+        "v1MnemonicLanguage": {
+            "type": "string",
+            "enum": [
+                "MNEMONIC_LANGUAGE_ENGLISH",
+                "MNEMONIC_LANGUAGE_SIMPLIFIED_CHINESE",
+                "MNEMONIC_LANGUAGE_TRADITIONAL_CHINESE",
+                "MNEMONIC_LANGUAGE_CZECH",
+                "MNEMONIC_LANGUAGE_FRENCH",
+                "MNEMONIC_LANGUAGE_ITALIAN",
+                "MNEMONIC_LANGUAGE_JAPANESE",
+                "MNEMONIC_LANGUAGE_KOREAN",
+                "MNEMONIC_LANGUAGE_SPANISH"
+            ]
+        },
         "v1NOOPCodegenAnchorResponse": {
             "type": "object",
             "properties": {
@@ -4173,6 +4299,13 @@
                         "type": "object",
                         "$ref": "#/definitions/v1Feature"
                     }
+                },
+                "wallets": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "$ref": "#/definitions/v1Wallet"
+                    }
                 }
             }
         },
@@ -4287,6 +4420,13 @@
                 },
                 "createdAt": {
                     "$ref": "#/definitions/externaldatav1Timestamp"
+                },
+                "updatedAt": {
+                    "$ref": "#/definitions/externaldatav1Timestamp"
+                },
+                "exported": {
+                    "type": "boolean",
+                    "description": "True when a given Private Key is exported, false otherwise."
                 }
             },
             "required": [
@@ -4296,7 +4436,9 @@
                 "curve",
                 "addresses",
                 "privateKeyTags",
-                "createdAt"
+                "createdAt",
+                "updatedAt",
+                "exported"
             ]
         },
         "v1PrivateKeyParams": {
@@ -4388,6 +4530,27 @@
             },
             "required": ["authenticator", "userId"]
         },
+        "v1RecoverUserRequest": {
+            "type": "object",
+            "properties": {
+                "type": {
+                    "type": "string",
+                    "enum": ["ACTIVITY_TYPE_RECOVER_USER"]
+                },
+                "timestampMs": {
+                    "type": "string",
+                    "description": "Timestamp (in milliseconds) of the request, used to verify liveness of user requests."
+                },
+                "organizationId": {
+                    "type": "string",
+                    "description": "Unique identifier for a given Organization."
+                },
+                "parameters": {
+                    "$ref": "#/definitions/v1RecoverUserIntent"
+                }
+            },
+            "required": ["type", "timestampMs", "organizationId", "parameters"]
+        },
         "v1RecoverUserResult": {
             "type": "object",
             "properties": {
@@ -4602,6 +4765,12 @@
                 },
                 "exportPrivateKeyResult": {
                     "$ref": "#/definitions/v1ExportPrivateKeyResult"
+                },
+                "exportWalletResult": {
+                    "$ref": "#/definitions/v1ExportWalletResult"
+                },
+                "createSubOrganizationResultV4": {
+                    "$ref": "#/definitions/v1CreateSubOrganizationResultV4"
                 }
             }
         },
@@ -4801,7 +4970,7 @@
             "properties": {
                 "signWith": {
                     "type": "string",
-                    "description": "The Private Key identifier or address."
+                    "description": "A Wallet account address, Private Key address, or Private Key identifier."
                 },
                 "payload": {
                     "type": "string",
@@ -4823,7 +4992,7 @@
             "properties": {
                 "type": {
                     "type": "string",
-                    "enum": ["ACTIVITY_TYPE_SIGN_RAW_PAYLOAD"]
+                    "enum": ["ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2"]
                 },
                 "timestampMs": {
                     "type": "string",
@@ -4834,7 +5003,7 @@
                     "description": "Unique identifier for a given Organization."
                 },
                 "parameters": {
-                    "$ref": "#/definitions/v1SignRawPayloadIntent"
+                    "$ref": "#/definitions/v1SignRawPayloadIntentV2"
                 }
             },
             "required": ["type", "timestampMs", "organizationId", "parameters"]
@@ -4857,27 +5026,6 @@
             },
             "required": ["r", "s", "v"]
         },
-        "v1SignRawPayloadV2Request": {
-            "type": "object",
-            "properties": {
-                "type": {
-                    "type": "string",
-                    "enum": ["ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2"]
-                },
-                "timestampMs": {
-                    "type": "string",
-                    "description": "Timestamp (in milliseconds) of the request, used to verify liveness of user requests."
-                },
-                "organizationId": {
-                    "type": "string",
-                    "description": "Unique identifier for a given Organization."
-                },
-                "parameters": {
-                    "$ref": "#/definitions/v1SignRawPayloadIntentV2"
-                }
-            },
-            "required": ["type", "timestampMs", "organizationId", "parameters"]
-        },
         "v1SignTransactionIntent": {
             "type": "object",
             "properties": {
@@ -4900,7 +5048,7 @@
             "properties": {
                 "signWith": {
                     "type": "string",
-                    "description": "The Private Key identifier or address."
+                    "description": "A Wallet account address, Private Key address, or Private Key identifier."
                 },
                 "unsignedTransaction": {
                     "type": "string",
@@ -4917,7 +5065,7 @@
             "properties": {
                 "type": {
                     "type": "string",
-                    "enum": ["ACTIVITY_TYPE_SIGN_TRANSACTION"]
+                    "enum": ["ACTIVITY_TYPE_SIGN_TRANSACTION_V2"]
                 },
                 "timestampMs": {
                     "type": "string",
@@ -4928,7 +5076,7 @@
                     "description": "Unique identifier for a given Organization."
                 },
                 "parameters": {
-                    "$ref": "#/definitions/v1SignTransactionIntent"
+                    "$ref": "#/definitions/v1SignTransactionIntentV2"
                 }
             },
             "required": ["type", "timestampMs", "organizationId", "parameters"]
@@ -4942,27 +5090,6 @@
             },
             "required": ["signedTransaction"]
         },
-        "v1SignTransactionV2Request": {
-            "type": "object",
-            "properties": {
-                "type": {
-                    "type": "string",
-                    "enum": ["ACTIVITY_TYPE_SIGN_TRANSACTION_V2"]
-                },
-                "timestampMs": {
-                    "type": "string",
-                    "description": "Timestamp (in milliseconds) of the request, used to verify liveness of user requests."
-                },
-                "organizationId": {
-                    "type": "string",
-                    "description": "Unique identifier for a given Organization."
-                },
-                "parameters": {
-                    "$ref": "#/definitions/v1SignTransactionIntentV2"
-                }
-            },
-            "required": ["type", "timestampMs", "organizationId", "parameters"]
-        },
         "v1SimpleClientExtensionResults": {
             "type": "object",
             "properties": {
@@ -5509,6 +5636,36 @@
                 "createdAt"
             ]
         },
+        "v1Wallet": {
+            "type": "object",
+            "properties": {
+                "walletId": {
+                    "type": "string",
+                    "description": "Unique identifier for a given Wallet."
+                },
+                "walletName": {
+                    "type": "string",
+                    "description": "Human-readable name for a Wallet."
+                },
+                "createdAt": {
+                    "$ref": "#/definitions/externaldatav1Timestamp"
+                },
+                "updatedAt": {
+                    "$ref": "#/definitions/externaldatav1Timestamp"
+                },
+                "exported": {
+                    "type": "boolean",
+                    "description": "True when a given Wallet is exported, false otherwise."
+                }
+            },
+            "required": [
+                "walletId",
+                "walletName",
+                "createdAt",
+                "updatedAt",
+                "exported"
+            ]
+        },
         "v1WalletAccountParams": {
             "type": "object",
             "properties": {
@@ -5531,6 +5688,40 @@
             },
             "required": ["curve", "pathFormat", "path", "addressFormat"]
         },
+        "v1WalletParams": {
+            "type": "object",
+            "properties": {
+                "walletName": {
+                    "type": "string",
+                    "description": "Human-readable name for a Wallet."
+                },
+                "accounts": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "$ref": "#/definitions/v1WalletAccountParams"
+                    },
+                    "description": "A list of wallet Accounts."
+                }
+            },
+            "required": ["walletName", "accounts"]
+        },
+        "v1WalletResult": {
+            "type": "object",
+            "properties": {
+                "walletId": {
+                    "type": "string"
+                },
+                "addresses": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "A list of account addresses."
+                }
+            },
+            "required": ["walletId", "addresses"]
+        },
         "v1WebAuthnStamp": {
             "type": "object",
             "properties": {
@@ -5582,15 +5773,19 @@
     "x-tagGroups": [
         {
             "name": "ORGANIZATIONS",
-            "tags": ["Organizations", "Invitations", "Policies"]
+            "tags": ["Organizations", "Invitations", "Policies", "Features"]
         },
         {
             "name": "PRIVATE KEYS",
-            "tags": ["Private Keys", "Private Key Tags"]
+            "tags": ["Wallets", "Signatures", "Private Keys", "Private Key Tags"]
         },
         {
             "name": "USERS",
-            "tags": ["Users", "User Tags", "Authenticators", "API Keys", "Who am I?"]
+            "tags": ["Users", "User Tags", "User Recovery"]
+        },
+        {
+            "name": "CREDENTIALS",
+            "tags": ["Authenticators", "API Keys", "Who am I?"]
         },
         {
             "name": "ACTIVITIES",