Feature: autogenerated docs update by PR (#364)

.github/workflows/api_reference_refresh.yml

@@ -47,4 +47,34 @@ jobs:
         run: echo "${{ steps.package.outputs.content }}"
 
       - name: Generate documentation with Dokka
-        run: ./gradlew dokkaHtml
+        run: ./gradlew dokkaHtml
+
+      - name: Setup Git user (GitHub Actions bot)
+        run: |
+          git config user.name TelnyxIntegrations
+          git config user.email [email protected]
+
+      - name: Configure git push.autoSetupRemote
+        run: |
+          git config push.autoSetupRemote true
+
+      - name: Create new branch name for docs
+        run: |
+          BRANCH_NAME="docs/update-$(date +'%Y%m%d%H%M%S')"
+          echo "branch_name=$BRANCH_NAME" >> $GITHUB_ENV
+
+      - name: Create Pull Request using GitHub Actions bot
+        uses: peter-evans/create-pull-request@v7
+        with:
+          add-paths: |
+            docs/
+          token: ${{ secrets.GITHUB_TOKEN }}
+          committer: TelnyxIntegrations <[email protected]>
+          base: main
+          branch: ${{ env.branch_name }}
+          delete-branch: true
+          title: '[docs] Update generated HTML documentation'
+          commit-message: "docs: Generated full documentation"
+          body: "This PR updates the full documentation generated by dokkaHtml."
+          labels: "documentation, auto-generated"
+          draft: false