update-openapi-docs.yml

name: Update OpenAPI Docs

on:
  push:
    branches: [ "main", "develop" ]
    paths:
      - "docs/openapi.yaml"
  workflow_dispatch:

permissions:
  contents: write
  
jobs:
  build-docs:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v6
        with:
          fetch-depth: 0

      - name: Setup Node
        uses: actions/setup-node@v6
        with:
          node-version: "24"

      - name: Install Redocly CLI
        run: npm install -g @redocly/cli

      - name: Build OpenAPI docs
        working-directory: docs
        run: |
          npx @redocly/cli build-docs openapi.yaml -o index.html

      - name: Commit & Push updated docs (only on push, not PR)
        run: |
          git config user.name "github-actions"
          git config user.email "github-actions@github.com"

          git add docs/index.html

          # Only commit and push if there are changes
          if ! git diff --cached --quiet; then
            git commit -m "chore: update openapi docs"
            git push origin ${GITHUB_REF#refs/heads/}
          else
            echo "No changes to commit."
          fi