@opusdns/api 0.31.0 → 0.33.0

package/src/openapi.yaml

@@ -1654,7 +1654,7 @@ components:
           $ref: '#/components/schemas/DomainSearchMeta'
         results:
           items:
-            $ref: '#/components/schemas/DomainSearchSuggestion'
+            $ref: '#/components/schemas/DomainSearchSuggestionWithPrice'
           title: Results
           type: array
       required:
@@ -1662,7 +1662,25 @@ components:
       - results
       title: DomainSearchResponse
       type: object
-    DomainSearchSuggestion:
+    DomainSearchSuggestionPriceData:
+      properties:
+        amount:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Amount
+        currency:
+          title: Currency
+          type: string
+        period:
+          $ref: '#/components/schemas/DomainPeriod'
+      required:
+      - amount
+      - currency
+      - period
+      title: DomainSearchSuggestionPriceData
+      type: object
+    DomainSearchSuggestionWithPrice:
       properties:
         available:
           title: Available
@@ -1673,11 +1691,14 @@ components:
         premium:
           title: Premium
           type: boolean
+        price:
+          $ref: '#/components/schemas/DomainSearchSuggestionPriceData'
       required:
       - domain
       - available
       - premium
-      title: DomainSearchSuggestion
+      - price
+      title: DomainSearchSuggestionWithPrice
       type: object
     DomainSortField:
       enum:
@@ -3550,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
@@ -3972,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
@@ -4485,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
@@ -4571,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:
@@ -4910,7 +5138,7 @@ info:
     '
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2025-09-05-075426
+  version: 2025-09-09-123217
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -8855,6 +9083,58 @@ paths:
       summary: Create User
       tags:
       - user
+  /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:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UserPasswordResetEmailResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      summary: Create User Password Reset
+      tags:
+      - user
+      - user
+  /v1/users/email/verify:
+    get:
+      operationId: redirect_verify_user_v1_users_email_verify_get
+      parameters:
+      - in: query
+        name: token
+        required: true
+        schema:
+          title: Token
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema: {}
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      summary: Redirect Verify User
+      tags:
+      - user
+      - user
   /v1/users/me:
     get:
       operationId: get_current_user_v1_users_me_get
@@ -8887,31 +9167,247 @@ paths:
       summary: Get Current User
       tags:
       - user
-  /v1/users/{user_id}:
-    delete:
-      operationId: delete_user_v1_users__user_id__delete
-      parameters:
-      - in: path
-        name: user_id
+  /v1/users/me/password-reset:
+    patch:
+      operationId: confirm_user_password_reset_me_v1_users_me_password_reset_patch
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PasswordUpdate'
         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':
+        '401':
           content:
             application/problem+json:
               example:
-                code: ERROR_USER_IS_LAST_ADMIN
-                detail: User is the last admin for the organization
-                status: 409
+                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:
@@ -9112,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