@opusdns/api 0.32.0 → 0.33.0

package/src/openapi.yaml

@@ -3571,6 +3571,17 @@ components:
       - pagination
       title: Pagination[User]
       type: object
+    PasswordUpdate:
+      properties:
+        new_password:
+          examples:
+          - correcthorsebatterystaple
+          title: New Password
+          type: string
+      required:
+      - new_password
+      title: PasswordUpdate
+      type: object
     PatchOp:
       enum:
       - upsert
@@ -3993,6 +4004,16 @@ components:
           title: Remove
       title: SpiceDbRelationshipUpdate
       type: object
+    StartPasswordReset:
+      properties:
+        email:
+          format: email
+          title: Email
+          type: string
+      required:
+      - email
+      title: StartPasswordReset
+      type: object
     SyncOperationType:
       enum:
       - registration
@@ -4506,6 +4527,17 @@ components:
       - notification
       title: UserNotificationSummary
       type: object
+    UserPasswordResetEmailResponse:
+      properties:
+        message:
+          default: A password reset link will be sent to this email if an account
+            is registered under it.
+          description: Message to the user. This message is always displayed regarding
+            the password reset process to prevent leaking information.
+          title: Message
+          type: string
+      title: UserPasswordResetEmailResponse
+      type: object
     UserStatus:
       enum:
       - active
@@ -4592,6 +4624,181 @@ components:
           title: Username
       title: UserUpdate
       type: object
+    UserVerificationApiResponse:
+      properties:
+        canceled_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: The date the verification was cancelled
+          title: Canceled On
+        created_on:
+          description: The date/time the entry was created on
+          format: date-time
+          title: Created On
+          type: string
+        status:
+          $ref: '#/components/schemas/EmailVerificationStatus'
+          default: pending
+          description: Current status of the email verification
+        token:
+          description: The token to verify the email address
+          maxLength: 256
+          minLength: 35
+          title: Token
+          type: string
+        type:
+          $ref: '#/components/schemas/VerificationType'
+          description: 'The type of verification: ''api'' for retrieving token via
+            API, ''email'' for retrieving via email'
+        updated_on:
+          description: The date/time the entry was last updated on
+          format: date-time
+          title: Updated On
+          type: string
+        user_id:
+          default: None
+          description: The user's id
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+        user_verification_id:
+          examples:
+          - user_verification_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_verification_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Verification Id
+          type: string
+          x-typeid-prefix: user_verification
+        verified_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: The date the verification was verified
+          title: Verified On
+      required:
+      - token
+      - type
+      title: UserVerificationApiResponse
+      type: object
+    UserVerificationEmailResponse:
+      properties:
+        canceled_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: The date the verification was cancelled
+          title: Canceled On
+        created_on:
+          description: The date/time the entry was created on
+          format: date-time
+          title: Created On
+          type: string
+        status:
+          $ref: '#/components/schemas/EmailVerificationStatus'
+          default: pending
+          description: Current status of the email verification
+        type:
+          $ref: '#/components/schemas/VerificationType'
+          description: 'The type of verification: ''api'' for retrieving token via
+            API, ''email'' for retrieving via email'
+        updated_on:
+          description: The date/time the entry was last updated on
+          format: date-time
+          title: Updated On
+          type: string
+        user_id:
+          default: None
+          description: The user's id
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+        user_verification_id:
+          examples:
+          - user_verification_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_verification_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Verification Id
+          type: string
+          x-typeid-prefix: user_verification
+        verified_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: The date the verification was verified
+          title: Verified On
+      required:
+      - type
+      title: UserVerificationEmailResponse
+      type: object
+    UserVerificationResponse:
+      properties:
+        canceled_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: The date the verification was cancelled
+          title: Canceled On
+        created_on:
+          description: The date/time the entry was created on
+          format: date-time
+          title: Created On
+          type: string
+        status:
+          $ref: '#/components/schemas/EmailVerificationStatus'
+          default: pending
+          description: Current status of the email verification
+        type:
+          $ref: '#/components/schemas/VerificationType'
+          description: 'The type of verification: ''api'' for retrieving token via
+            API, ''email'' for retrieving via email'
+        updated_on:
+          description: The date/time the entry was last updated on
+          format: date-time
+          title: Updated On
+          type: string
+        user_id:
+          default: None
+          description: The user's id
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+        user_verification_id:
+          examples:
+          - user_verification_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_verification_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Verification Id
+          type: string
+          x-typeid-prefix: user_verification
+        verified_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: The date the verification was verified
+          title: Verified On
+      required:
+      - type
+      title: UserVerificationResponse
+      type: object
     UserWithAttributes:
       properties:
         created_on:
@@ -4931,7 +5138,7 @@ info:
     '
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2025-09-05-210401
+  version: 2025-09-09-123217
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -8876,26 +9083,21 @@ paths:
       summary: Create User
       tags:
       - user
-  /v1/users/me:
-    get:
-      operationId: get_current_user_v1_users_me_get
-      parameters:
-      - in: query
-        name: attributes
-        required: false
-        schema:
-          anyOf:
-          - items:
-              type: string
-            type: array
-          - type: 'null'
-          title: Attributes
+  /v1/users/email/password-reset:
+    post:
+      operationId: create_user_password_reset_v1_users_email_password_reset_post
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/StartPasswordReset'
+        required: true
       responses:
-        '200':
+        '201':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/UserWithRelationPermissions'
+                $ref: '#/components/schemas/UserPasswordResetEmailResponse'
           description: Successful Response
         '422':
           content:
@@ -8903,66 +9105,40 @@ paths:
               schema:
                 $ref: '#/components/schemas/HTTPValidationError'
           description: Validation Error
-      security:
-      - OAuth2PasswordBearer: []
-      summary: Get Current User
+      summary: Create User Password Reset
       tags:
       - user
-  /v1/users/{user_id}:
-    delete:
-      operationId: delete_user_v1_users__user_id__delete
+      - user
+  /v1/users/email/verify:
+    get:
+      operationId: redirect_verify_user_v1_users_email_verify_get
       parameters:
-      - in: path
-        name: user_id
+      - in: query
+        name: token
         required: true
         schema:
-          examples:
-          - user_01h45ytscbebyvny4gc8cr8ma2
-          format: typeid
-          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
-          title: User Id
+          title: Token
           type: string
-          x-typeid-prefix: user
       responses:
-        '204':
-          description: Successful Response
-        '409':
+        '200':
           content:
-            application/problem+json:
-              example:
-                code: ERROR_USER_IS_LAST_ADMIN
-                detail: User is the last admin for the organization
-                status: 409
-                title: User Management Error
-                type: user-is-last-admin
-              schema:
-                $ref: '#/components/schemas/Problem'
-          description: Conflict
+            application/json:
+              schema: {}
+          description: Successful Response
         '422':
           content:
             application/problem+json:
               schema:
                 $ref: '#/components/schemas/HTTPValidationError'
           description: Validation Error
-      security:
-      - OAuth2PasswordBearer: []
-      summary: Delete User
+      summary: Redirect Verify User
       tags:
       - user
+      - user
+  /v1/users/me:
     get:
-      operationId: get_user_v1_users__user_id__get
+      operationId: get_current_user_v1_users_me_get
       parameters:
-      - in: path
-        name: user_id
-        required: true
-        schema:
-          examples:
-          - user_01h45ytscbebyvny4gc8cr8ma2
-          format: typeid
-          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
-          title: User Id
-          type: string
-          x-typeid-prefix: user
       - in: query
         name: attributes
         required: false
@@ -8978,7 +9154,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/UserWithAttributes'
+                $ref: '#/components/schemas/UserWithRelationPermissions'
           description: Successful Response
         '422':
           content:
@@ -8988,15 +9164,314 @@ paths:
           description: Validation Error
       security:
       - OAuth2PasswordBearer: []
-      summary: Get User
+      summary: Get Current User
       tags:
       - user
+  /v1/users/me/password-reset:
     patch:
-      operationId: update_user_v1_users__user_id__patch
-      parameters:
-      - in: path
-        name: user_id
-        required: true
+      operationId: confirm_user_password_reset_me_v1_users_me_password_reset_patch
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PasswordUpdate'
+        required: true
+      responses:
+        '204':
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Confirm User Password Reset Me
+      tags:
+      - user
+      - user
+  /v1/users/me/verification:
+    delete:
+      operationId: cancel_verification_me_v1_users_me_verification_delete
+      responses:
+        '204':
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Cancel Verification Me
+      tags:
+      - user
+      - user
+    get:
+      operationId: get_verification_status_me_v1_users_me_verification_get
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserVerificationResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Get Verification Status Me
+      tags:
+      - user
+      - user
+    patch:
+      operationId: update_verification_me_v1_users_me_verification_patch
+      parameters:
+      - in: query
+        name: token
+        required: true
+        schema:
+          title: Token
+          type: string
+      responses:
+        '204':
+          description: Successful Response
+        '400':
+          content:
+            application/problem+json:
+              examples:
+                User Management Error:
+                  value:
+                    code: ERROR_USER_VERIFICATION_TOKEN_INVALID
+                    detail: Invalid verification token
+                    status: 400
+                    title: User Management Error
+                    type: user-verification-token-invalid
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Bad Request
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_USER_VERIFICATION_NOT_FOUND
+                detail: 'No user verification found for user: user_id=Additional error
+                  context.'
+                status: 404
+                title: User Management Error
+                type: user-verification-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Update Verification Me
+      tags:
+      - user
+      - user
+    post:
+      operationId: create_verification_me_v1_users_me_verification_post
+      parameters:
+      - in: query
+        name: type
+        required: true
+        schema:
+          $ref: '#/components/schemas/VerificationType'
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                anyOf:
+                - $ref: '#/components/schemas/UserVerificationEmailResponse'
+                - $ref: '#/components/schemas/UserVerificationApiResponse'
+                title: Response Create Verification Me V1 Users Me Verification Post
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_USER_NOT_FOUND
+                detail: Additional error context.
+                status: 404
+                title: User Management Error
+                type: user-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '405':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_USER_VERIFICATION_INVALID_TYPE
+                detail: 'Invalid verification type: Additional error context.'
+                status: 405
+                title: User Management Error
+                type: user-verification-type-invalid
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Method Not Allowed
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Create Verification Me
+      tags:
+      - user
+      - user
+  /v1/users/{user_id}:
+    delete:
+      operationId: delete_user_v1_users__user_id__delete
+      parameters:
+      - in: path
+        name: user_id
+        required: true
+        schema:
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+      responses:
+        '204':
+          description: Successful Response
+        '409':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_USER_IS_LAST_ADMIN
+                detail: User is the last admin for the organization
+                status: 409
+                title: User Management Error
+                type: user-is-last-admin
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Conflict
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Delete User
+      tags:
+      - user
+    get:
+      operationId: get_user_v1_users__user_id__get
+      parameters:
+      - in: path
+        name: user_id
+        required: true
+        schema:
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+      - in: query
+        name: attributes
+        required: false
+        schema:
+          anyOf:
+          - items:
+              type: string
+            type: array
+          - type: 'null'
+          title: Attributes
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserWithAttributes'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Get User
+      tags:
+      - user
+    patch:
+      operationId: update_user_v1_users__user_id__patch
+      parameters:
+      - in: path
+        name: user_id
+        required: true
         schema:
           examples:
           - user_01h45ytscbebyvny4gc8cr8ma2
@@ -9133,6 +9608,245 @@ paths:
       summary: Update User Relations
       tags:
       - user
+  /v1/users/{user_id}/verification:
+    delete:
+      operationId: cancel_verification_v1_users__user_id__verification_delete
+      parameters:
+      - in: path
+        name: user_id
+        required: true
+        schema:
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+      responses:
+        '204':
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Cancel Verification
+      tags:
+      - user
+      - user
+    get:
+      operationId: get_verification_status_v1_users__user_id__verification_get
+      parameters:
+      - in: path
+        name: user_id
+        required: true
+        schema:
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserVerificationResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Get Verification Status
+      tags:
+      - user
+      - user
+    patch:
+      operationId: update_verification_v1_users__user_id__verification_patch
+      parameters:
+      - in: path
+        name: user_id
+        required: true
+        schema:
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+      - in: query
+        name: token
+        required: true
+        schema:
+          title: Token
+          type: string
+      responses:
+        '204':
+          description: Successful Response
+        '400':
+          content:
+            application/problem+json:
+              examples:
+                User Management Error:
+                  value:
+                    code: ERROR_USER_VERIFICATION_TOKEN_INVALID
+                    detail: Invalid verification token
+                    status: 400
+                    title: User Management Error
+                    type: user-verification-token-invalid
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Bad Request
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_USER_VERIFICATION_NOT_FOUND
+                detail: 'No user verification found for user: user_id=Additional error
+                  context.'
+                status: 404
+                title: User Management Error
+                type: user-verification-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Update Verification
+      tags:
+      - user
+      - user
+    post:
+      operationId: create_verification_v1_users__user_id__verification_post
+      parameters:
+      - in: path
+        name: user_id
+        required: true
+        schema:
+          examples:
+          - user_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^user_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: User Id
+          type: string
+          x-typeid-prefix: user
+      - in: query
+        name: type
+        required: true
+        schema:
+          $ref: '#/components/schemas/VerificationType'
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                anyOf:
+                - $ref: '#/components/schemas/UserVerificationEmailResponse'
+                - $ref: '#/components/schemas/UserVerificationApiResponse'
+                title: Response Create Verification V1 Users  User Id  Verification
+                  Post
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_USER_NOT_FOUND
+                detail: Additional error context.
+                status: 404
+                title: User Management Error
+                type: user-not-found
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '405':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_USER_VERIFICATION_INVALID_TYPE
+                detail: 'Invalid verification type: Additional error context.'
+                status: 405
+                title: User Management Error
+                type: user-verification-type-invalid
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Method Not Allowed
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Create Verification
+      tags:
+      - user
+      - user
 servers:
 - description: Production environment
   url: https://api.opusdns.com