API governance

Three Root Causes: Why we lose to the invisible man

After identifying unforced errors in API design, I found three root causes on the tennis court that map directly to how we build APIs. Here's what they are and how to fix them.

By Adam AltmanFebruary 05, 2026

Beat the Invisible Man: Unforced errors in API design

Most APIs don't fail because competitors outplayed them. They fail because of unforced errors—small mistakes that shouldn't exist. Here's how to identify and eliminate them.

By Adam AltmanJanuary 29, 2026

Improve OpenAPI security with defensive linting rules

Some simple rules to add to your OpenAPI linting setup as a quick way to catch some small but dangerous API mistakes.

By Lorna MitchellOctober 02, 2024

Best practices for building and adopting an API governance strategy

API governance is important. Learn how to do it well.

By Lorna MitchellAugust 29, 2024

Lint Arazzo workflow files with Redocly CLI

Adopting new standards requires great tools. Use Redocly CLI to lint your OpenAPI, AsyncAPI and Arazzo format descriptions.

By Lorna MitchellJuly 24, 2024

Ensure consistent APIs with Redocly and GitHub Actions

Put some magic API tools in your continuous integration and make a good API grow up to be a great API.

By Lorna MitchellMay 15, 2024

Getting started with API governance

Take your first steps to better APIs with our approachable guide to getting started with API governance.

By Lorna MitchellMay 08, 2024

Lint OpenAPI, lint Markdown. Now lint Markdown in OpenAPI.

Use Redocly's API tooling to apply custom validation to your API descriptions, such as checking Markdown is valid.

By Lorna MitchellFebruary 14, 2024

Build your own API guidelines

Build better APIs using API guidelines. Use our interactive quiz to define your API ruleset in collaboration with your team.

By Lorna MitchellJanuary 17, 2024

Your linting rulesets are not your API governance

Beyond the code, API style guides define the identity and values of your API

By Lorna MitchellDecember 14, 2023

API Governance: Shift-Left to Save Money and Accelerate Velocity

I'll walk you through why when it comes to API governance shifting left is the way to go and how to actually do it.

By Adam AltmanNovember 03, 2023

Redocly for technical writers

How Redocly helps technical writers create superior documentation experiences

By Swapnil OgaleAugust 05, 2022

Where to store your OpenAPI definitions

Part 1 of our series of posts around managing OpenAPI definitions with Redocly

By Swapnil OgaleJanuary 07, 2021