late-sdk 0.0.83 → 0.0.85

data/openapi.yaml

@@ -5360,6 +5360,83 @@ paths:
         '404': { $ref: '#/components/responses/NotFound' }
         '500':
           description: Platform API deletion failed
+  /v1/posts/{postId}/update-metadata:
+    post:
+      operationId: updatePostMetadata
+      tags: [Posts]
+      summary: Update post metadata
+      description: |
+        Updates metadata of an already-published post on the specified platform without re-uploading the media.
+        Currently only supported for YouTube videos (title, description, tags, category, privacy status).
+        The post must have "published" status on the target platform. At least one updatable field is required.
+      parameters:
+        - name: postId
+          in: path
+          required: true
+          schema: { type: string }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [platform]
+              properties:
+                platform:
+                  type: string
+                  description: The platform to update metadata on
+                  enum:
+                    - youtube
+                title:
+                  type: string
+                  maxLength: 100
+                  description: New video title (max 100 characters for YouTube)
+                description:
+                  type: string
+                  description: New video description
+                tags:
+                  type: array
+                  items:
+                    type: string
+                    maxLength: 100
+                  description: Array of keyword tags (max 500 characters combined for YouTube)
+                categoryId:
+                  type: string
+                  description: YouTube video category ID
+                privacyStatus:
+                  type: string
+                  enum: [public, private, unlisted]
+                  description: Video privacy setting
+            example:
+              platform: "youtube"
+              title: "Updated Video Title"
+              description: "New SEO-optimized description"
+              tags: ["seo", "marketing", "tutorial"]
+      responses:
+        '200':
+          description: Metadata updated successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  message: { type: string }
+                  updatedFields:
+                    type: array
+                    items: { type: string }
+              example:
+                success: true
+                message: "Video metadata updated on youtube successfully"
+                updatedFields: ["title", "description", "tags"]
+        '400':
+          description: "Invalid request: unsupported platform, post not published, missing fields, or validation error."
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: Forbidden
+        '404': { $ref: '#/components/responses/NotFound' }
+        '500':
+          description: Platform API update failed
   /v1/users:
     get:
       operationId: listUsers
@@ -14625,6 +14702,377 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
 
+  # ─── WhatsApp Group Chats (platform groups, not contact groups) ──
+
+  /v1/whatsapp/wa-groups:
+    get:
+      operationId: listWhatsAppGroupChats
+      tags: [WhatsApp]
+      summary: List active groups
+      description: |
+        List active WhatsApp group chats for a business phone number.
+        These are actual WhatsApp group conversations on the platform.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+        - { name: limit, in: query, schema: { type: integer, default: 25, maximum: 1024 }, description: Max groups to return }
+        - { name: after, in: query, schema: { type: string }, description: Pagination cursor }
+      responses:
+        '200':
+          description: List of active groups
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  groups:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id: { type: string, description: Group ID }
+                        subject: { type: string, description: Group name }
+                        createdAt: { type: string, description: Group creation timestamp }
+                  paging:
+                    type: object
+                    properties:
+                      cursors:
+                        type: object
+                        properties:
+                          after: { type: string }
+                          before: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+    post:
+      operationId: createWhatsAppGroupChat
+      tags: [WhatsApp]
+      summary: Create group
+      description: |
+        Create a new WhatsApp group chat. Returns the group ID and optionally an invite link.
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, subject]
+              properties:
+                accountId: { type: string, description: WhatsApp social account ID }
+                subject: { type: string, maxLength: 128, description: Group name (max 128 characters) }
+                description: { type: string, maxLength: 2048, description: Group description (max 2048 characters) }
+                joinApprovalMode:
+                  type: string
+                  enum: [approval_required, auto_approve]
+                  description: Whether users need approval to join via invite link
+      responses:
+        '201':
+          description: Group created
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  group:
+                    type: object
+                    properties:
+                      groupId: { type: string }
+                      inviteLink: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+
+  /v1/whatsapp/wa-groups/{groupId}:
+    get:
+      operationId: getWhatsAppGroupChat
+      tags: [WhatsApp]
+      summary: Get group info
+      description: |
+        Retrieve metadata about a WhatsApp group including subject, description,
+        participants, and settings.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      responses:
+        '200':
+          description: Group info
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  group:
+                    type: object
+                    properties:
+                      id: { type: string }
+                      subject: { type: string }
+                      description: { type: string }
+                      joinApprovalMode: { type: string }
+                      participants:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            user: { type: string, description: Phone number }
+                            admin: { type: string }
+                      participantCount: { type: integer }
+                      createdAt: { type: integer, description: UNIX timestamp }
+                      isSuspended: { type: boolean }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { $ref: '#/components/responses/NotFound' }
+    post:
+      operationId: updateWhatsAppGroupChat
+      tags: [WhatsApp]
+      summary: Update group settings
+      description: |
+        Update the subject, description, or join approval mode of a WhatsApp group.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                subject: { type: string, maxLength: 128 }
+                description: { type: string, maxLength: 2048 }
+                joinApprovalMode: { type: string, enum: [approval_required, auto_approve] }
+      responses:
+        '200':
+          description: Group updated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  message: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { $ref: '#/components/responses/NotFound' }
+    delete:
+      operationId: deleteWhatsAppGroupChat
+      tags: [WhatsApp]
+      summary: Delete group
+      description: |
+        Delete a WhatsApp group and remove all participants.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      responses:
+        '200':
+          description: Group deleted
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  message: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { $ref: '#/components/responses/NotFound' }
+
+  /v1/whatsapp/wa-groups/{groupId}/participants:
+    post:
+      operationId: addWhatsAppGroupParticipants
+      tags: [WhatsApp]
+      summary: Add participants
+      description: |
+        Add participants to a WhatsApp group. Maximum 8 participants per request.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [phoneNumbers]
+              properties:
+                phoneNumbers:
+                  type: array
+                  maxItems: 8
+                  items: { type: string }
+                  description: Phone numbers in E.164 format (max 8)
+      responses:
+        '200':
+          description: Participants added
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  message: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+    delete:
+      operationId: removeWhatsAppGroupParticipants
+      tags: [WhatsApp]
+      summary: Remove participants
+      description: |
+        Remove participants from a WhatsApp group.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [phoneNumbers]
+              properties:
+                phoneNumbers:
+                  type: array
+                  items: { type: string }
+                  description: Phone numbers to remove
+      responses:
+        '200':
+          description: Participants removed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  message: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+
+  /v1/whatsapp/wa-groups/{groupId}/invite-link:
+    post:
+      operationId: createWhatsAppGroupInviteLink
+      tags: [WhatsApp]
+      summary: Create invite link
+      description: |
+        Create a new invite link for a WhatsApp group. The previous link is revoked.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      responses:
+        '200':
+          description: Invite link created
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  inviteLink: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+
+  /v1/whatsapp/wa-groups/{groupId}/join-requests:
+    get:
+      operationId: listWhatsAppGroupJoinRequests
+      tags: [WhatsApp]
+      summary: List join requests
+      description: |
+        List pending join requests for a WhatsApp group (only for groups with approval_required mode).
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      responses:
+        '200':
+          description: Join requests
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  joinRequests:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        user: { type: string, description: Phone number }
+                        timestamp: { type: integer, description: UNIX timestamp of request }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+    post:
+      operationId: approveWhatsAppGroupJoinRequests
+      tags: [WhatsApp]
+      summary: Approve join requests
+      description: |
+        Approve pending join requests for a WhatsApp group.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [phoneNumbers]
+              properties:
+                phoneNumbers:
+                  type: array
+                  items: { type: string }
+                  description: Phone numbers to approve
+      responses:
+        '200':
+          description: Requests approved
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  message: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+    delete:
+      operationId: rejectWhatsAppGroupJoinRequests
+      tags: [WhatsApp]
+      summary: Reject join requests
+      description: |
+        Reject pending join requests for a WhatsApp group.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: groupId, in: path, required: true, schema: { type: string }, description: Group ID }
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: WhatsApp social account ID }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [phoneNumbers]
+              properties:
+                phoneNumbers:
+                  type: array
+                  items: { type: string }
+                  description: Phone numbers to reject
+      responses:
+        '200':
+          description: Requests rejected
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  message: { type: string }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+
   # ─── Contacts ─────────────────────────────────────────────────────
 
   /v1/contacts:

data/spec/api/posts_api_spec.rb

@@ -141,4 +141,17 @@ describe 'PostsApi' do
     end
   end
 
+  # unit tests for update_post_metadata
+  # Update post metadata
+  # Updates metadata of an already-published post on the specified platform without re-uploading the media. Currently only supported for YouTube videos (title, description, tags, category, privacy status). The post must have \"published\" status on the target platform. At least one updatable field is required. 
+  # @param post_id 
+  # @param update_post_metadata_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UpdatePostMetadata200Response]
+  describe 'update_post_metadata test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/api/whats_app_api_spec.rb

@@ -45,6 +45,34 @@ describe 'WhatsAppApi' do
     end
   end
 
+  # unit tests for add_whats_app_group_participants
+  # Add participants
+  # Add participants to a WhatsApp group. Maximum 8 participants per request. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param add_whats_app_group_participants_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UnpublishPost200Response]
+  describe 'add_whats_app_group_participants test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for approve_whats_app_group_join_requests
+  # Approve join requests
+  # Approve pending join requests for a WhatsApp group. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param approve_whats_app_group_join_requests_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UnpublishPost200Response]
+  describe 'approve_whats_app_group_join_requests test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for bulk_delete_whats_app_contacts
   # Bulk delete contacts
   # **Deprecated.** Use `DELETE /v1/contacts/{id}` for individual deletes instead. Permanently delete multiple contacts at once (max 500 per request). 
@@ -105,6 +133,31 @@ describe 'WhatsAppApi' do
     end
   end
 
+  # unit tests for create_whats_app_group_chat
+  # Create group
+  # Create a new WhatsApp group chat. Returns the group ID and optionally an invite link. 
+  # @param create_whats_app_group_chat_request 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateWhatsAppGroupChat201Response]
+  describe 'create_whats_app_group_chat test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for create_whats_app_group_invite_link
+  # Create invite link
+  # Create a new invite link for a WhatsApp group. The previous link is revoked. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param [Hash] opts the optional parameters
+  # @return [CreateWhatsAppGroupInviteLink200Response]
+  describe 'create_whats_app_group_invite_link test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for create_whats_app_template
   # Create template
   # Create a new message template. Supports two modes:  **Custom template:** Provide `components` with your own content. Submitted to Meta for review (can take up to 24h).  **Library template:** Provide `library_template_name` instead of `components` to use a pre-built template from Meta's template library. Library templates are **pre-approved** (no review wait). You can optionally customize parameters and buttons via `library_template_body_inputs` and `library_template_button_inputs`.  Browse available library templates at: https://business.facebook.com/wa/manage/message-templates/ 
@@ -153,6 +206,19 @@ describe 'WhatsAppApi' do
     end
   end
 
+  # unit tests for delete_whats_app_group_chat
+  # Delete group
+  # Delete a WhatsApp group and remove all participants. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param [Hash] opts the optional parameters
+  # @return [UnpublishPost200Response]
+  describe 'delete_whats_app_group_chat test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for delete_whats_app_template
   # Delete template
   # Permanently delete a message template by name. 
@@ -262,6 +328,19 @@ describe 'WhatsAppApi' do
     end
   end
 
+  # unit tests for get_whats_app_group_chat
+  # Get group info
+  # Retrieve metadata about a WhatsApp group including subject, description, participants, and settings. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param [Hash] opts the optional parameters
+  # @return [GetWhatsAppGroupChat200Response]
+  describe 'get_whats_app_group_chat test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for get_whats_app_groups
   # List contact groups
   # **Deprecated.** Use contact tags via `GET /v1/contacts` for grouping instead. WhatsApp groups have no cross-platform equivalent. List all contact groups for a WhatsApp account with contact counts. Groups are derived from the groups field on contacts, not stored as separate documents. 
@@ -311,6 +390,47 @@ describe 'WhatsAppApi' do
     end
   end
 
+  # unit tests for list_whats_app_group_chats
+  # List active groups
+  # List active WhatsApp group chats for a business phone number. These are actual WhatsApp group conversations on the platform. 
+  # @param account_id WhatsApp social account ID
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :limit Max groups to return
+  # @option opts [String] :after Pagination cursor
+  # @return [ListWhatsAppGroupChats200Response]
+  describe 'list_whats_app_group_chats test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for list_whats_app_group_join_requests
+  # List join requests
+  # List pending join requests for a WhatsApp group (only for groups with approval_required mode). 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param [Hash] opts the optional parameters
+  # @return [ListWhatsAppGroupJoinRequests200Response]
+  describe 'list_whats_app_group_join_requests test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for reject_whats_app_group_join_requests
+  # Reject join requests
+  # Reject pending join requests for a WhatsApp group. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param reject_whats_app_group_join_requests_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UnpublishPost200Response]
+  describe 'reject_whats_app_group_join_requests test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for remove_whats_app_broadcast_recipients
   # Remove recipients
   # **Deprecated.** Use `POST /v1/broadcasts/{id}/recipients` with removal flag instead. Remove recipients from a draft broadcast by phone number. 
@@ -324,6 +444,20 @@ describe 'WhatsAppApi' do
     end
   end
 
+  # unit tests for remove_whats_app_group_participants
+  # Remove participants
+  # Remove participants from a WhatsApp group. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param remove_whats_app_group_participants_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UnpublishPost200Response]
+  describe 'remove_whats_app_group_participants test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for rename_whats_app_group
   # Rename group
   # **Deprecated.** Use contact tags via `PATCH /v1/contacts/{id}` instead. Rename a contact group. This updates the group name on all contacts that belong to the group. 
@@ -410,6 +544,20 @@ describe 'WhatsAppApi' do
     end
   end
 
+  # unit tests for update_whats_app_group_chat
+  # Update group settings
+  # Update the subject, description, or join approval mode of a WhatsApp group. 
+  # @param group_id Group ID
+  # @param account_id WhatsApp social account ID
+  # @param update_whats_app_group_chat_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UnpublishPost200Response]
+  describe 'update_whats_app_group_chat test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for update_whats_app_template
   # Update template
   # Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated.