Fix mistakes, add delete totp pending, change descriptions

Added `DELETE /auth/twofactorauth/totp/pending`
Fixed `POST /auth/user/resendEmail` request path
Removed `POST /auth/user/resendEmail` empty request body
Marked `POST /auth/register` as deprecated
Changed descriptions for endpoints

Author: VinyarionHyarmendacil

openapi/components/codeSamples/authentication.yaml

@@ -28,13 +28,11 @@
         curl -X POST "https://api.vrchat.cloud/api/1/auth/register" \
              -H "Content-Type: application/json" \
              --data '{"username": "{userAndDisplayName}", "password": "{password}", "email": "{emailAddress}", "year": "{birthYear}", "month": "{birthMonth}", "day": "{birthDay}", "captchaCode": "{captchaCode}", "subscribe": true, "acceptedTOSVersion": 10}'
-/auth/resendEmail:
+/auth/user/resendEmail:
   post:
     - lang: cURL
       source: >-
-        curl -X POST "https://api.vrchat.cloud/api/1/auth/resendEmail" \
-             -H "Content-Type: application/json" \
-             --data '{}'
+        curl -X POST "https://api.vrchat.cloud/api/1/auth/user/resendEmail"
 /auth/confirmEmail:
   get:
     - lang: cURL
@@ -65,6 +63,11 @@
       source: >-
         curl -X POST "https://api.vrchat.cloud/api/1/auth/twofactorauth/totp/pending" \
              -b "auth={authCookie}"
+  delete:
+    - lang: cURL
+      source: >-
+        curl -X DELETE "https://api.vrchat.cloud/api/1/auth/twofactorauth/totp/pending" \
+             -b "auth={authCookie}"
 /auth/twofactorauth/totp/pending/verify:
   post:
     - lang: cURL

openapi/components/paths.yaml

@@ -30,8 +30,8 @@
   $ref: "./paths/authentication.yaml#/paths/~1users~1{userId}~1delete"
 "/auth/register":
   $ref: "./paths/authentication.yaml#/paths/~1auth~1register"
-"/auth/resendEmail":
-  $ref: "./paths/authentication.yaml#/paths/~1auth~1resendEmail"
+"/auth/user/resendEmail":
+  $ref: "./paths/authentication.yaml#/paths/~1auth~1user~1resendEmail"
 "/auth/confirmEmail":
   $ref: "./paths/authentication.yaml#/paths/~1auth~1confirmEmail"
 "/auth/verifyLoginPlace":

openapi/components/paths/authentication.yaml

@@ -129,6 +129,22 @@ paths:
       security:
         - authCookie: []
       parameters: []
+    delete:
+      summary: Cancel pending enabling of time-based 2FA codes
+      operationId: cancelPending2FA
+      x-codeSamples:
+        $ref: "../codeSamples/authentication.yaml#/~1auth~1twofactorauth~1totp~1pending/delete"
+      responses:
+        '200':
+          $ref: ../responses/authentication/Disable2FAResponse.yaml
+        '401':
+          $ref: ../responses/MissingCredentialsError.yaml
+      description: Cancels the sequence for enabling time-based 2FA.
+      tags:
+        - authentication
+      security:
+        - authCookie: []
+      parameters: []
   /auth/twofactorauth/totp/pending/verify:
     post:
       summary: Verify Pending 2FA code
@@ -258,7 +274,12 @@ paths:
   /auth/register:
     post:
       summary: Register User Account
-      description: Verify whether the currently provided Auth Token is valid.
+      description: |-
+        ~~Register a new user account.~~
+        
+        **DEPRECATED:** Automated creation of accounts has no legitimate public third-party use case, and would be in violation of ToS §13.2:
+        *By using the Platform, you agree not to: i. [...] use the Platform in a manner inconsistent with individual human usage*
+        This endpoint is documented in the interest of completeness
       requestBody:
         required: true
         content:
@@ -274,16 +295,11 @@ paths:
       parameters: []
       tags:
         - authentication
-  /auth/resendEmail:
+      deprecated: true
+  /auth/user/resendEmail:
     post:
       summary: Resend Email Confirmation
-      description: Verify whether the currently provided Auth Token is valid.
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: ../requests/ResendEmailConfirmationRequest.yaml
+      description: Requests a resend of pending email address confirmation email
       responses:
         '200':
           $ref: ../responses/authentication/ResendVerificationEmailSuccess.yaml