API Governance in a Monorepo

Your monorepo has 5 services, each with its own OpenAPI spec. A PR touches two of them. You need breaking change reports for each service independently.

Multiple specs, one workflow

name: API Governance
on:
  pull_request:
    paths:
      - 'services/*/api/openapi.yaml'

jobs:
  check-users:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: delimit-ai/delimit-action@v1
        with:
          spec: services/users/api/openapi.yaml

  check-billing:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: delimit-ai/delimit-action@v1
        with:
          spec: services/billing/api/openapi.yaml

  check-notifications:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: delimit-ai/delimit-action@v1
        with:
          spec: services/notifications/api/openapi.yaml

Each job runs independently and posts its own PR comment. The users service gets its own breaking change report. Billing gets its own. No cross-contamination.

Different policies per service

Each service can have its own .delimit/policies.yml. Freeze your billing API while your notifications API evolves freely.

- uses: delimit-ai/delimit-action@v1
  with:
    spec: services/billing/api/openapi.yaml
    policy_file: services/billing/.delimit/policies.yml
    mode: enforce