chore: Update OpenAPI spec build workflow

Author: mattheworris

.github/workflows/common/openapi-build/action.yaml

@@ -1,11 +1,11 @@
 name: Build and Publish OpenAPI UI
+description: "Build and publish OpenAPI UI for a service"
 
-on:
-  workflow_call:
-    inputs:
-      service:
-        required: true
-        type: string
+inputs:
+  service:
+    description: "The name of the service to build OpenAPI UI for"
+    required: true
+    type: string
 
 runs:
   using: "composite"

.github/workflows/deploy-gh-pages.yaml

@@ -47,7 +47,7 @@ jobs:
       # Upload the mdBook output to GitHub Pages
       - name: Upload mdbook to GitHub Pages
         if: matrix.service == 'account' # Only upload mdbook once
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: mdbook
           path: ./docs/book
@@ -59,7 +59,7 @@ jobs:
           service: ${{ matrix.service }}
 
       - name: Upload OpenAPI UI to GitHub Pages
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
           name: openapi-${{ matrix.service }}
           path: ./docs/${{ matrix.service }}
@@ -76,31 +76,31 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Download mdbook artifact
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: mdbook
           path: ./docs/book
 
       - name: Download account OpenAPI artifacts
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: openapi-account
           path: ./docs/account
 
       - name: Download content-watcher OpenAPI artifacts
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: openapi-content-watcher
           path: ./docs/content-watcher
 
       - name: Download content-publishing OpenAPI artifacts
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: openapi-content-publishing
           path: ./docs/content-publishing
 
       - name: Download graph OpenAPI artifacts
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: openapi-graph
           path: ./docs/graph