Add info

Author: mariananantua

VTEX - Weni by VTEX API.json

@@ -387,12 +387,31 @@
                                                     "items": {
                                                         "type": "object",
                                                         "description": "Information about the groups that received the broadcast.",
-                                                        "properties": {
-                                                            "id": {
-                                                                
-                                                            }
-                                                        }
+                                                        "example": [
+                                                            "Group 1",
+                                                            "Group 2"
+                                                        ] 
                                                     }
+                                                },
+                                                "text": {
+                                                    "type": "string",
+                                                    "description": "The text of the broadcast.",
+                                                    "example": "Hello, world."
+                                                },
+                                                "status": {
+                                                    "type": "string",
+                                                    "description": "The status of the broadcast.",
+                                                    "enum": [
+                                                        "queued",
+                                                        "sent",
+                                                        "failed"
+                                                    ],
+                                                    "example": "sent"
+                                                },
+                                                "created_on": {
+                                                    "type": "string",
+                                                    "description": "The date when the broadcast was created in the UTC time format: `YYYY-MM-DDT`.",
+                                                    "example": "2025-12-25T17:28:12.123456Z"
                                                 }
                                             }
                                          }
@@ -419,9 +438,9 @@
                 "tags": [
                     "Broadcasts"
                 ],
-                "summary": "POST broadcasts",
-                "description": "List and send message broadcasts",
-                "operationId": "POSTBroadcasts",
+                "summary": "Post Weni Flows broadcasts",
+                "description": "Create and send new broadcasts.",
+                "operationId": "PostBroadcasts",
                 "parameters": [
                     {
                         "name": "Authorization",
@@ -434,13 +453,51 @@
                         }
                     }
                 ],
+                "requestBody": {
+                    "required": true,
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "type": "object",
+                                "properties": {
+                                    "text": {
+                                        "type": "string",
+                                        "description": "The text of the broadcast. You can send a text of up to 640 characters per request.",
+                                        "example": "Hello @contact.name"
+                                    },
+                                    "urns": {
+                                        "type": "array",
+                                        "description": "List of URNs that will receive the broadcast. You can send up to 100 URNs per request.",
+                                        "required": false,
+                                        "items": {
+                                            "type": "string",
+                                            "description": "URNs of the recipient.",
+                                            "example": [
+                                                "tel:+250788123123",
+                                                "tel:+250788123124"
+                                            ]
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                },
                 "responses": {
                     "200": {
                         "description": "OK",
                         "content": {
                             "application/json": {
                                 "schema": {
-                                    "type": "object"
+                                    "type": "object",
+                                    "properties": {
+                                        "next": {
+                                            "$ref": "#/components/schemas/NextPage"
+                                        },
+                                        "previous": {
+                                            "$ref": "#/components/schemas/PreviousPage"
+                                        },
+                                    }
                                 }
                             }
                         }
@@ -457,16 +514,6 @@
                     "429": {
                         "description": "Rate limit exceeded - You have exceeded the rate limit for this endpoint"
                     }
-                },
-                "requestBody": {
-                    "required": true,
-                    "content": {
-                        "application/json": {
-                            "schema": {
-                                "type": "object"
-                            }
-                        }
-                    }
                 }
             }
         },