Update

Author: vdusek

.github/workflows/regenerate_models.yaml

@@ -7,11 +7,15 @@ on:
         description: "PR number in apify/apify-docs that triggered this workflow"
         required: true
         type: string
-      docs_pr_branch:
-        description: "Branch name in apify/apify-docs PR"
+      docs_pr_sha:
+        description: "Commit SHA from the apify/apify-docs PR"
         required: true
         type: string
 
+permissions:
+  contents: write
+  pull-requests: write
+
 concurrency:
   group: regenerate-models-${{ inputs.docs_pr_number }}
   cancel-in-progress: true
@@ -25,11 +29,11 @@ jobs:
       - name: Checkout apify-client-python
         uses: actions/checkout@v6
 
-      - name: Checkout apify-docs at PR branch
+      - name: Checkout apify-docs at PR commit
         uses: actions/checkout@v6
         with:
           repository: apify/apify-docs
-          ref: ${{ inputs.docs_pr_branch }}
+          ref: ${{ inputs.docs_pr_sha }}
           path: apify-docs
           token: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
 
@@ -115,12 +119,27 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
 
       - name: Comment on apify-docs PR
-        if: steps.changes.outputs.changed == 'true' && steps.pr.outputs.created == 'true'
+        if: steps.changes.outputs.changed == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
         run: |
+          if [ "${{ steps.pr.outputs.created }}" = "true" ]; then
+            COMMENT="A PR to update the Python client models has been created: ${{ steps.pr.outputs.pr_url }}
+
+          This was automatically triggered by OpenAPI specification changes in this PR."
+          else
+            COMMENT="The Python client model PR has been updated with the latest OpenAPI spec changes: ${{ steps.pr.outputs.pr_url }}"
+          fi
+
           gh pr comment "${{ inputs.docs_pr_number }}" \
             --repo apify/apify-docs \
-            --body "A PR to update the Python client models has been created in apify-client-python: ${{ steps.pr.outputs.pr_url }}
+            --body "$COMMENT"
 
-          This was automatically triggered by OpenAPI specification changes in this PR."
+      - name: Comment on failure
+        if: failure()
         env:
           GITHUB_TOKEN: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
+        run: |
+          gh pr comment "${{ inputs.docs_pr_number }}" \
+            --repo apify/apify-docs \
+            --body "Python client model regeneration failed. [See workflow run](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})."