Merge pull request #402 from openai/spec-2025-01-17

Spec changes 2025-01-17

Author: kwhinnery-openai

.github/workflows/validate-openapi.yml

@@ -1,27 +1,17 @@
-name: Validate OpenAPI definition
+name: Run Spectral on Pull Requests
+
 on:
-  pull_request:
-    types: [opened, reopened, synchronize]
+  - pull_request
 
 jobs:
-  validate_openapi:
+  build:
+    name: Run Spectral
     runs-on: ubuntu-latest
-    name: Swagger Editor Validator Service
-
-    # Service containers to run with `runner-job`
-    services:
-      # Label used to access the service container
-      swagger-editor:
-        # Docker Hub image
-        image: swaggerapi/swagger-editor
-        ports:
-          # Maps port 8080 on service container to the host 80
-          - 80:8080
-
     steps:
-      - uses: actions/checkout@v2
-      - name: Validate OpenAPI definition
-        uses: char0n/swagger-editor-validate@v1
+      # Check out the repository
+      - uses: actions/checkout@v3
+
+      # Run Spectral
+      - uses: stoplightio/spectral-action@latest
         with:
-          swagger-editor-url: http://localhost/
-          definition-file: openapi.yaml
+          file_glob: 'openapi.yaml'

.spectral.yaml

@@ -0,0 +1,4 @@
+extends: ["spectral:oas"]
+rules:
+  no-$ref-siblings: off
+  oas3-valid-schema-example: off