Merge pull request #85 from clerk/update-openapi-specs-20260204-182352

chore: Update OpenAPI Specs

Author: Jibaru

bapi/2025-11-10.yml

@@ -6945,6 +6945,55 @@ paths:
           $ref: '#/components/responses/ClerkErrors'
         '422':
           $ref: '#/components/responses/UnprocessableEntity'
+  /waitlist_entries/bulk:
+    post:
+      operationId: CreateBulkWaitlistEntries
+      x-speakeasy-group: waitlistEntries
+      x-speakeasy-name-override: bulkCreate
+      summary: Create multiple waitlist entries
+      description: |-
+        Creates multiple waitlist entries for the provided email addresses.
+        You can choose whether to send confirmation emails by setting the `notify` parameter to `true` or `false` for each entry.
+        If the `notify` parameter is omitted, it defaults to `true`.
+
+        If an email address is already on the waitlist, no new entry will be created and the existing waitlist entry will be returned.
+        Duplicate email addresses within the same request are not allowed.
+
+        This endpoint is limited to a maximum of 50 entries per API call. If you need to add more entries, please make multiple requests.
+      tags:
+        - Waitlist Entries
+      requestBody:
+        description: Required parameters
+        content:
+          application/json:
+            schema:
+              type: array
+              minItems: 1
+              maxItems: 50
+              items:
+                type: object
+                additionalProperties: false
+                properties:
+                  email_address:
+                    type: string
+                    format: email
+                    description: The email address to add to the waitlist
+                  notify:
+                    type: boolean
+                    description: |-
+                      Optional flag which denotes whether a confirmation email should be sent to the given email address.
+                      Defaults to `true`.
+                    nullable: true
+                    default: true
+                required:
+                  - email_address
+      responses:
+        '200':
+          $ref: '#/components/responses/WaitlistEntry.List'
+        '400':
+          $ref: '#/components/responses/ClerkErrors'
+        '422':
+          $ref: '#/components/responses/UnprocessableEntity'
   /waitlist_entries/{waitlist_entry_id}:
     delete:
       operationId: DeleteWaitlistEntry
@@ -15719,6 +15768,14 @@ components:
         application/json:
           schema:
             $ref: '#/components/schemas/WaitlistEntry'
+    WaitlistEntry.List:
+      description: Array of waitlist entries
+      content:
+        application/json:
+          schema:
+            type: array
+            items:
+              $ref: '#/components/schemas/WaitlistEntry'
     CommercePlan.List:
       description: A list of commerce plans.
       content:

webhooks/2025-04-15.yml

@@ -4134,7 +4134,7 @@ components:
         period_end:
           type: integer
           format: int64
-          description: Unix timestamp in milliseconds when the subscription item period ends
+          description: Unix timestamp in milliseconds when the subscription item period ends. The field is null for default plan subscription items.
           nullable: true
         interval:
           type: string