A GitHub Action that validates OpenAPI documents against the Nitro registry.

- uses: ChilliCream/nitro-openapi-validate@v16
  with:
    stage: <stage>
    openapi-collection-id: <openapi-collection-id>
    api-key: <api-key>
    patterns:
      - ./endpoints/**/*.graphql
      - ./models/Person.graphql
    # Optional
    comment-mode: none
    cloud-url: <cloud-url>

If you self-host Nitro or use a dedicated hosted instance, you can specify the cloud-url input to point to your instance.

Use comment-mode to control pull request feedback behavior.

comment-mode: comment comments on the pull request - requires issues: write permissions

comment-mode: review creates a pull request review with a comment - requires pull-requests: write permissions

Example for comment-mode: comment:

jobs:
  validate:
    permissions:
      contents: read
      issues: write

Example for comment-mode: review:

jobs:
  validate:
    permissions:
      contents: read
      pull-requests: write

Note: When you define job-level permissions, GitHub no longer applies the default permission set for that job. Make sure to explicitly include every permission the job needs (for example contents: read).