<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st" -->

---
title: Audit breaking changes with the Buf Schema Registry's...
description: The Buf Schema Registry (BSR) now offers a governance workflow for Enterprise customers that lets administrators review, approve, or reject commits introducing...
canonical: https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st
twitter:card: summary_large_image
twitter:site: @dailydotdev
og:type: website
og:site_name: daily.dev
og:title: Audit breaking changes with the Buf Schema Registry's governance workflow · Buf | daily.dev
og:description: The Buf Schema Registry (BSR) now offers a governance workflow for Enterprise customers that lets administrators review, approve, or reject commits introducing...
og:url: https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st
og:image: https://api.daily.dev/og/posts/guLLQO2sT.png
og:image:alt: Audit breaking changes with the Buf Schema Registry's governance workflow · Buf
og:image:width: 1200
og:image:height: 630
og:locale: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit breaking changes with the Buf Schema Registry's governance workflow · Buf

**[Buf Blog](https://daily.dev/sources/buf)** · 4 min read · 0 upvotes · 0 comments

## Summary

The Buf Schema Registry (BSR) now offers a governance workflow for Enterprise customers that lets administrators review, approve, or reject commits introducing breaking changes to Protobuf schemas. Commits with breaking changes are automatically held in a 'Pending' state, blocking downstream consumers like generated SDKs and reflection APIs until an admin reviews them. Reviewers are notified via email and a new BSR Inbox, and reverting a bad commit automatically clears its review requirement, providing a full audit trail of schema evolution.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://buf.build/blog/review-governance-workflow>

## Questions this post answers

### How does the Buf Schema Registry handle breaking changes to Protobuf schemas after they're merged in git?

The Buf Schema Registry (BSR) now includes a governance workflow, available on the Enterprise plan, that automatically moves any commit containing a breaking change to a 'Pending' state on the main branch, hiding it from downstream consumers like generated SDKs, Buf Studio, and reflection APIs until a module administrator reviews and approves or rejects it.

_Teams enforcing schema governance can follow Protobuf and API tooling updates like this on daily.dev._

### What happens if a breaking Protobuf commit gets rejected in the Buf Schema Registry?

A rejected commit stays blocked from downstream consumers and is marked 'Rejected' on the module's Commits tab, requiring a follow-up fix such as reverting the commit in git or patching it. Once the diff against main no longer contains a breaking change, the BSR automatically approves the corrected commit without manual intervention.

_daily.dev helps API owners track how registries like Buf handle breaking-change reviews and reverts._

## Similar posts on daily.dev

- [The modern Protobuf workflow · Buf](https://daily.dev/posts/the-modern-protobuf-workflow-buf-c2m7gywhe) · Buf Blog · 1 upvotes · 0 comments
- [Introducing NetBox Changes v1.0: Governance at the Layer Where the Change Actually Happens](https://daily.dev/posts/introducing-netbox-changes-v1-0-governance-at-the-layer-where-the-change-actually-happens-umvp4cvp1) · NetBox Labs · 0 upvotes · 0 comments
- [Push Schema Revisions Before Deployment](https://daily.dev/posts/push-schema-revisions-before-deployment-yctq0utvg) · The Guild · 0 upvotes · 0 comments
- [API Reviews and Provenance: Accountability Over Enforcement](https://daily.dev/posts/api-reviews-and-provenance-accountability-over-enforcement-0ofr3x9e0) · API Evangelist · 3 upvotes · 0 comments
- [Database Change Governance: Reduce Audit Prep Time From Weeks to Hours \| Liquibase Secure](https://daily.dev/posts/database-change-governance-reduce-audit-prep-time-from-weeks-to-hours-liquibase-secure-9fbgm5gut) · Security Boulevard · 0 upvotes · 0 comments

---

Tags: [#architecture](https://daily.dev/tags/architecture), [#backend](https://daily.dev/tags/backend)

[View this post on daily.dev](https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]}
{"@context":"https://schema.org","@type":"TechArticle","headline":"Audit breaking changes with the Buf Schema Registry's governance workflow · Buf","url":"https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st"},"datePublished":"2026-08-23T07:20:08.905Z","dateModified":"2026-08-23T07:20:27.489Z","description":"The Buf Schema Registry (BSR) now offers a governance workflow for Enterprise customers that lets administrators review, approve, or reject commits introducing...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/85cdc1f7077ec7dc2ef8adb83692eb2a?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/85cdc1f7077ec7dc2ef8adb83692eb2a?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Buf Blog","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Buf Blog","logo":"https://media.daily.dev/image/upload/s--2YBgo_Nm--/f_auto,q_auto/v1787469605/logos/buf?_a=BAMAMicg0","url":"https://daily.dev/sources/buf"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"architecture,backend","timeRequired":"PT4M"}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Buf Blog","item":"https://daily.dev/sources/buf"},{"@type":"ListItem","position":3,"name":"Audit breaking changes with the Buf Schema Registry's governance workflow · Buf"}]}
{"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/audit-breaking-changes-with-the-buf-schema-registry-s-governance-workflow-buf-gullqo2st#faq","mainEntity":[{"@type":"Question","name":"How does the Buf Schema Registry handle breaking changes to Protobuf schemas after they're merged in git?","acceptedAnswer":{"@type":"Answer","text":"The Buf Schema Registry (BSR) now includes a governance workflow, available on the Enterprise plan, that automatically moves any commit containing a breaking change to a 'Pending' state on the main branch, hiding it from downstream consumers like generated SDKs, Buf Studio, and reflection APIs until a module administrator reviews and approves or rejects it. Teams enforcing schema governance can follow Protobuf and API tooling updates like this on daily.dev."}},{"@type":"Question","name":"What happens if a breaking Protobuf commit gets rejected in the Buf Schema Registry?","acceptedAnswer":{"@type":"Answer","text":"A rejected commit stays blocked from downstream consumers and is marked 'Rejected' on the module's Commits tab, requiring a follow-up fix such as reverting the commit in git or patching it. Once the diff against main no longer contains a breaking change, the BSR automatically approves the corrected commit without manual intervention. daily.dev helps API owners track how registries like Buf handle breaking-change reviews and reverts."}}]}
```

